Versions

Python SDK reference for the analyses.versions resource

Note

The Bevor SDK is coming soon. This page previews its planned Python interface.

Access this resource from client.analyses.versions. Both async and sync clients expose the same methods.

create_chat

POST /chats

result = await client.analyses.versions.create_chat(
    version_id=version_id,
)

Arguments:

version_idIDbodyrequired

Returns: ChatSchema

show properties (11)hide properties (11)
idstringrequired
created_atstringrequired
team_idstringrequired
team_slugstringrequired
project_idstringrequired
project_slugstringrequired
total_messagesintegerrequired
code_idstringrequired
version_idOptional[string]
titleOptional[string]
chat_type'code' | 'analysis'required

get

GET /security/versions/{version_id}

result = await client.analyses.versions.get(
    version_id=version_id,
)

Arguments:

version_idIDpathrequired

Returns: VersionSchema

show properties (17)hide properties (17)
idstringrequired
created_atstringrequired
trigger'create' | 'commit' | 'fork' | 'merge' | 'push'required
n_findingsintegerrequired
n_remediationsintegerrequired
is_headbooleanrequired
has_pipeline_processingbooleanrequired
has_pipeline_failedbooleanrequired
code_versionCodeVersionSchemarequired
show properties (9)hide properties (9)
idstringrequired
networkOptional['eth' | 'bsc' | 'polygon' | 'base' | 'avax' | 'mode' | 'arb' | 'eth_sepolia' | 'bsc_test' | 'polygon_amoy' | 'base_sepolia' | 'avax_fuji' | 'mode_testnet' | 'arb_sepolia']
version_method'tag' | 'commit' | 'hash' | 'address'required
version_fingerprintstringrequired
status'queued' | 'processing' | 'failed' | 'success'required
nameOptional[string]
branchOptional[string]
commitOptional[GithubCommitSchema]
show properties (4)hide properties (4)
shastringrequired
authorstringrequired
messagestringrequired
timestampstringrequired
repositoryOptional[GithubRepositorySchema]
show properties (4)hide properties (4)
idintegerrequired
namestringrequired
is_privatebooleanrequired
accountGithubAccountSchemarequired
show properties (4)hide properties (4)
idintegerrequired
loginstringrequired
typestringrequired
avatar_urlstringrequired
merged_from_versionOptional[AnalysisVersionRef]
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
forked_from_versionOptional[AnalysisVersionRef]
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
parent_versionOptional[AnalysisVersionRef]
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
child_versionsarray of AnalysisVersionRef
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
merged_versionsarray of AnalysisVersionRef
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
forked_versionsarray of AnalysisVersionRef
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
actionsAnalysisActionsrequired
show properties (10)hide properties (10)
can_forkbooleanrequired
can_create_childbooleanrequired
can_commit_changesbooleanrequired
can_deletebooleanrequired
can_run_pipelinebooleanrequired
can_retry_pipelinebooleanrequired
can_merge_tobooleanrequired
can_merge_frombooleanrequired
can_stage_changesbooleanrequired
can_set_as_headbooleanrequired
analysis_metaAnalysisMetadataSchemarequired
show properties (8)hide properties (8)
idstringrequired
namestringrequired
created_atstringrequired
userUserSchemarequired
show properties (4)hide properties (4)
idstringrequired
is_selfbooleanrequired
created_atstringrequired
usernamestringrequired
project_idstringrequired
project_namestringrequired
project_slugstringrequired
is_ownerbooleanrequired

list

GET /security/versions

result = await client.analyses.versions.list()

Arguments:

optionsVersionsQueryParams | Nonequery
default:None

VersionsQueryParams

pageOptional[integer]
page_sizeOptional[integer]
orderOptional['desc' | 'asc']
analysis_idOptional[string]
project_idOptional[string]
project_slugOptional[string]
user_idOptional[string]
is_ownerOptional[string]
forked_from_version_idOptional[string]
merged_from_version_idOptional[string]
parent_version_idOptional[string]
triggerOptional['create' | 'commit' | 'fork' | 'merge' | 'push']
code_idOptional[string]
with_paginationboolquery
default:False

Return type by call:

  • with_pagination=True → PaginatedResource[VersionSchema]
  • with_pagination=False → Pagination[VersionSchema]
show properties (6)hide properties (6)
resultsarray of VersionSchema
show properties (17)hide properties (17)
idstringrequired
created_atstringrequired
trigger'create' | 'commit' | 'fork' | 'merge' | 'push'required
n_findingsintegerrequired
n_remediationsintegerrequired
is_headbooleanrequired
has_pipeline_processingbooleanrequired
has_pipeline_failedbooleanrequired
code_versionCodeVersionSchemarequired
show properties (9)hide properties (9)
idstringrequired
networkOptional['eth' | 'bsc' | 'polygon' | 'base' | 'avax' | 'mode' | 'arb' | 'eth_sepolia' | 'bsc_test' | 'polygon_amoy' | 'base_sepolia' | 'avax_fuji' | 'mode_testnet' | 'arb_sepolia']
version_method'tag' | 'commit' | 'hash' | 'address'required
version_fingerprintstringrequired
status'queued' | 'processing' | 'failed' | 'success'required
nameOptional[string]
branchOptional[string]
commitOptional[GithubCommitSchema]
show properties (4)hide properties (4)
shastringrequired
authorstringrequired
messagestringrequired
timestampstringrequired
repositoryOptional[GithubRepositorySchema]
show properties (4)hide properties (4)
idintegerrequired
namestringrequired
is_privatebooleanrequired
accountGithubAccountSchemarequired
show properties (4)hide properties (4)
idintegerrequired
loginstringrequired
typestringrequired
avatar_urlstringrequired
merged_from_versionOptional[AnalysisVersionRef]
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
forked_from_versionOptional[AnalysisVersionRef]
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
parent_versionOptional[AnalysisVersionRef]
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
child_versionsarray of AnalysisVersionRef
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
merged_versionsarray of AnalysisVersionRef
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
forked_versionsarray of AnalysisVersionRef
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
actionsAnalysisActionsrequired
show properties (10)hide properties (10)
can_forkbooleanrequired
can_create_childbooleanrequired
can_commit_changesbooleanrequired
can_deletebooleanrequired
can_run_pipelinebooleanrequired
can_retry_pipelinebooleanrequired
can_merge_tobooleanrequired
can_merge_frombooleanrequired
can_stage_changesbooleanrequired
can_set_as_headbooleanrequired
analysis_metaAnalysisMetadataSchemarequired
show properties (8)hide properties (8)
idstringrequired
namestringrequired
created_atstringrequired
userUserSchemarequired
show properties (4)hide properties (4)
idstringrequired
is_selfbooleanrequired
created_atstringrequired
usernamestringrequired
project_idstringrequired
project_namestringrequired
project_slugstringrequired
is_ownerbooleanrequired
pageintegerrequired
page_sizeintegerrequired
morebooleanrequired
total_observationsintegerrequired
total_pagesintegerrequired

delete

DELETE /security/versions/{version_id}

result = await client.analyses.versions.delete(
    version_id=version_id,
)

Arguments:

version_idIDpathrequired

Returns: AnalysisSchema

show properties (9)hide properties (9)
idstringrequired
namestringrequired
created_atstringrequired
userUserSchemarequired
show properties (4)hide properties (4)
idstringrequired
is_selfbooleanrequired
created_atstringrequired
usernamestringrequired
project_idstringrequired
project_namestringrequired
project_slugstringrequired
is_ownerbooleanrequired
versionAnalysisVersionSchemarequired
show properties (16)hide properties (16)
idstringrequired
created_atstringrequired
trigger'create' | 'commit' | 'fork' | 'merge' | 'push'required
n_findingsintegerrequired
n_remediationsintegerrequired
is_headbooleanrequired
has_pipeline_processingbooleanrequired
has_pipeline_failedbooleanrequired
code_versionCodeVersionSchemarequired
show properties (9)hide properties (9)
idstringrequired
networkOptional['eth' | 'bsc' | 'polygon' | 'base' | 'avax' | 'mode' | 'arb' | 'eth_sepolia' | 'bsc_test' | 'polygon_amoy' | 'base_sepolia' | 'avax_fuji' | 'mode_testnet' | 'arb_sepolia']
version_method'tag' | 'commit' | 'hash' | 'address'required
version_fingerprintstringrequired
status'queued' | 'processing' | 'failed' | 'success'required
nameOptional[string]
branchOptional[string]
commitOptional[GithubCommitSchema]
show properties (4)hide properties (4)
shastringrequired
authorstringrequired
messagestringrequired
timestampstringrequired
repositoryOptional[GithubRepositorySchema]
show properties (4)hide properties (4)
idintegerrequired
namestringrequired
is_privatebooleanrequired
accountGithubAccountSchemarequired
show properties (4)hide properties (4)
idintegerrequired
loginstringrequired
typestringrequired
avatar_urlstringrequired
merged_from_versionOptional[AnalysisVersionRef]
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
forked_from_versionOptional[AnalysisVersionRef]
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
parent_versionOptional[AnalysisVersionRef]
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
child_versionsarray of AnalysisVersionRef
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
merged_versionsarray of AnalysisVersionRef
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
forked_versionsarray of AnalysisVersionRef
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
actionsAnalysisActionsrequired
show properties (10)hide properties (10)
can_forkbooleanrequired
can_create_childbooleanrequired
can_commit_changesbooleanrequired
can_deletebooleanrequired
can_run_pipelinebooleanrequired
can_retry_pipelinebooleanrequired
can_merge_tobooleanrequired
can_merge_frombooleanrequired
can_stage_changesbooleanrequired
can_set_as_headbooleanrequired

On this page