Analyses

Python SDK reference for the analyses resource

Note

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

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

list

GET /security/analyses

result = await client.analyses.list()

Arguments:

optionsAnalysesQueryParams | Nonequery
default:None

AnalysesQueryParams

pageOptional[integer]
page_sizeOptional[integer]
order_byOptional['created_at' | 'updated_at']
orderOptional['desc' | 'asc']
project_idOptional[string]
project_slugOptional[string]
user_idOptional[string]
is_ownerOptional[boolean]
with_paginationboolquery
default:False

Return type by call:

  • with_pagination=True → PaginatedResource[AnalysisSchema]
  • with_pagination=False → Pagination[AnalysisSchema]
show properties (6)hide properties (6)
resultsarray of 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
pageintegerrequired
page_sizeintegerrequired
morebooleanrequired
total_observationsintegerrequired
total_pagesintegerrequired

get

GET /security/analyses/{analysis_id}

result = await client.analyses.get(
    analysis_id=analysis_id,
)

Arguments:

analysis_idIDpathrequired
optionsVersionQueryParams | Nonequery
default:None

VersionQueryParams

version_idOptional[string]

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

recent

GET /security/analyses/recent

result = await client.analyses.recent()

Arguments:

optionsLatestQueryParams | Nonequery
default:None

LatestQueryParams

project_idOptional[string]
project_slugOptional[string]

Returns: ExistsResponse[AnalysisExpandedSchema]

show properties (2)hide properties (2)
existsbooleanrequired
dataOptional[AnalysisExpandedSchema]
show properties (10)hide properties (10)
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
findingsarray of FindingSchema
show properties (21)hide properties (21)
versionAnalysisVersionRefrequired
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
created_atstringrequired
origin_finding_idstringrequired
is_acknowledgedbooleanrequired
typestringrequired
level'critical' | 'high' | 'medium' | 'low'required
namestringrequired
explanationstringrequired
recommendationOptional[string]
referenceOptional[string]
sourcestringrequired
idstringrequired
node_idstringrequired
is_borrowedbooleanrequired
location_idOptional[string]
created_by_userUserSchemarequired
show properties (4)hide properties (4)
idstringrequired
is_selfbooleanrequired
created_atstringrequired
usernamestringrequired
project_idstringrequired
project_slugstringrequired
code_idstringrequired
operationOptional['add' | 'update' | 'delete']
actionsFindingActionsrequired
show properties (3)hide properties (3)
can_editbooleanrequired
can_revertbooleanrequired
can_deletebooleanrequired

update

PATCH /security/analyses/{analysis_id}

result = await client.analyses.update(
    analysis_id=analysis_id,
    name=name,
)

Arguments:

analysis_idIDpathrequired
namestrbodyrequired

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

delete

DELETE /security/analyses/{analysis_id}

result = await client.analyses.delete(
    analysis_id=analysis_id,
)

Arguments:

analysis_idIDpathrequired

Returns: BooleanResponse

show properties (1)hide properties (1)
successbooleanrequired

create_root

POST /security/analyses

result = await client.analyses.create_root(
    body=body,
)

Arguments:

bodyCreateAnalysisRootBodyDictbodyrequired

CreateAnalysisRootBodyDict

code_idstringrequired
on_collisionOptional['surface' | 'force' | 'merge']
nameOptional[string]

Returns: AnalysisCreateSchema

create_child

POST /security/analyses/{analysis_id}/child

result = await client.analyses.create_child(
    analysis_id=analysis_id,
    body=body,
)

Arguments:

analysis_idIDpathrequired
bodyCreateAnalysisChildBodyDictbodyrequired

CreateAnalysisChildBodyDict

code_idstringrequired
on_collisionOptional['surface' | 'force' | 'merge']
version_idOptional[string]

Returns: AnalysisCreateSchema

fork

POST /security/analyses/{analysis_id}/fork

result = await client.analyses.fork(
    analysis_id=analysis_id,
)

Arguments:

analysis_idIDpathrequired
bodyVersionBodyDict | Nonebody
default:None

VersionBodyDict

version_idOptional[string]

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

merge

POST /security/merge

result = await client.analyses.merge(
    body=body,
)

Arguments:

bodyMergeAnalysisBodyDictbodyrequired

MergeAnalysisBodyDict

from_version_idstringrequired
to_version_idstringrequired

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

commit

POST /security/analyses/{analysis_id}/commit

result = await client.analyses.commit(
    analysis_id=analysis_id,
)

Arguments:

analysis_idIDpathrequired
bodyVersionBodyDict | Nonebody
default:None

VersionBodyDict

version_idOptional[string]

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

set_head

POST /security/analyses/{version_id}/head

result = await client.analyses.set_head(
    analysis_id=analysis_id,
    body=body,
)

Arguments:

analysis_idIDbodyrequired
bodySetHeadBodyDictbodyrequired

SetHeadBodyDict

version_idstringrequired

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

entrypoints

GET /security/analyses/{analysis_id}/entrypoints

result = await client.analyses.entrypoints(
    analysis_id=analysis_id,
)

Arguments:

analysis_idIDpathrequired
optionsVersionQueryParams | Nonequery
default:None

VersionQueryParams

version_idOptional[string]

Returns: ResultsResponse[EntryPointSchema]

show properties (1)hide properties (1)
resultsarray of EntryPointSchema
show properties (6)hide properties (6)
nodeGraphSnapshotNoderequired
show properties (23)hide properties (23)
idstringrequired
file_idstringrequired
file_pathstringrequired
short_idstringrequired
node_typestringrequired
sub_typeOptional[string]
src_start_posintegerrequired
src_end_posintegerrequired
pathstringrequired
docstringOptional[string]
namestringrequired
merkle_hashstringrequired
visibilityOptional['external' | 'public' | 'internal' | 'private']
mutabilityOptional[string]
is_virtualboolean
is_implementedboolean
signatureOptional[string]
is_callablebooleanrequired
is_declarationbooleanrequired
is_containerbooleanrequired
is_entrypointbooleanrequired
fieldsarray of FieldMetadataItem
show properties (6)hide properties (6)
namestringrequired
typeOptional[string]
valueOptional[string]
mutabilityOptional[string]
discriminantOptional[integer]
constraintsarray of ConstraintItem
show properties (2)hide properties (2)
namestringrequired
valueOptional[array of string]
parametersarray of ParameterStorageMetadata
show properties (7)hide properties (7)
param_indexintegerrequired
start_byteintegerrequired
is_readboolean
is_writtenboolean
fieldOptional[string]
param_nameOptional[string]
type_nameOptional[string]
is_analyzedbooleanrequired
is_inheritedbooleanrequired
is_analyzed_in_currentbooleanrequired
pipeline_status'not_run' | 'queued' | 'processing' | 'success' | 'failed'required
n_findingsinteger

list_findings

GET /security/analyses/{analysis_id}/findings

result = await client.analyses.list_findings(
    analysis_id=analysis_id,
)

Arguments:

analysis_idIDpathrequired
optionsVersionQueryParams | Nonequery
default:None

VersionQueryParams

version_idOptional[string]

Returns: ResultsResponse[FindingSchema]

show properties (1)hide properties (1)
resultsarray of FindingSchema
show properties (21)hide properties (21)
versionAnalysisVersionRefrequired
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
created_atstringrequired
origin_finding_idstringrequired
is_acknowledgedbooleanrequired
typestringrequired
level'critical' | 'high' | 'medium' | 'low'required
namestringrequired
explanationstringrequired
recommendationOptional[string]
referenceOptional[string]
sourcestringrequired
idstringrequired
node_idstringrequired
is_borrowedbooleanrequired
location_idOptional[string]
created_by_userUserSchemarequired
show properties (4)hide properties (4)
idstringrequired
is_selfbooleanrequired
created_atstringrequired
usernamestringrequired
project_idstringrequired
project_slugstringrequired
code_idstringrequired
operationOptional['add' | 'update' | 'delete']
actionsFindingActionsrequired
show properties (3)hide properties (3)
can_editbooleanrequired
can_revertbooleanrequired
can_deletebooleanrequired

add_findings

POST /security/analyses/{analysis_id}/findings

result = await client.analyses.add_findings(
    analysis_id=analysis_id,
    body=body,
)

Arguments:

analysis_idIDpathrequired
bodyAddFindingBodyDictbodyrequired

AddFindingBodyDict

version_idOptional[string]
findingsarray of FindingBodyDictrequired

FindingBodyDict

sourceOptional[string]
metadataOptional[FindingMetadataDict]

FindingMetadataDict

typestringrequired
level'critical' | 'high' | 'medium' | 'low'required
namestringrequired
explanationstringrequired
recommendationOptional[string]
referenceOptional[string]
locationFindingLocationNodeIdDict | FindingLocationPhysicalDict | FindingLocationLogicalDictrequired

FindingLocationNodeIdDict

strategystringrequired
node_idOptional[string]
location_idOptional[string]

FindingLocationPhysicalDict

strategystringrequired
uristringrequired
startLineOptional[integer]
startColumnOptional[integer]
endLineOptional[integer]
endColumnOptional[integer]
charOffsetOptional[integer]
charLengthOptional[integer]
byteOffsetOptional[integer]
byteLengthOptional[integer]

FindingLocationLogicalDict

strategystringrequired
fully_qualified_namestringrequired

Returns: ResultsResponse[FindingSchema]

show properties (1)hide properties (1)
resultsarray of FindingSchema
show properties (21)hide properties (21)
versionAnalysisVersionRefrequired
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
created_atstringrequired
origin_finding_idstringrequired
is_acknowledgedbooleanrequired
typestringrequired
level'critical' | 'high' | 'medium' | 'low'required
namestringrequired
explanationstringrequired
recommendationOptional[string]
referenceOptional[string]
sourcestringrequired
idstringrequired
node_idstringrequired
is_borrowedbooleanrequired
location_idOptional[string]
created_by_userUserSchemarequired
show properties (4)hide properties (4)
idstringrequired
is_selfbooleanrequired
created_atstringrequired
usernamestringrequired
project_idstringrequired
project_slugstringrequired
code_idstringrequired
operationOptional['add' | 'update' | 'delete']
actionsFindingActionsrequired
show properties (3)hide properties (3)
can_editbooleanrequired
can_revertbooleanrequired
can_deletebooleanrequired

diff_staged

GET /security/analyses/{analysis_id}/diff/staged

result = await client.analyses.diff_staged(
    analysis_id=analysis_id,
)

Arguments:

analysis_idIDpathrequired
optionsVersionQueryParams | Nonequery
default:None

VersionQueryParams

version_idOptional[string]

Returns: ResultsResponse[FindingDiffItem]

show properties (1)hide properties (1)
resultsarray of FindingDiffItem
show properties (6)hide properties (6)
idstringrequired
operation'add' | 'update' | 'delete'required
reason'edit' | 'code'required
previousOptional[FindingBareSchema]
show properties (11)hide properties (11)
versionAnalysisVersionRefrequired
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
created_atstringrequired
origin_finding_idstringrequired
is_acknowledgedbooleanrequired
typestringrequired
level'critical' | 'high' | 'medium' | 'low'required
namestringrequired
explanationstringrequired
recommendationOptional[string]
referenceOptional[string]
sourcestringrequired
currentOptional[FindingBareSchema]
show properties (11)hide properties (11)
versionAnalysisVersionRefrequired
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
created_atstringrequired
origin_finding_idstringrequired
is_acknowledgedbooleanrequired
typestringrequired
level'critical' | 'high' | 'medium' | 'low'required
namestringrequired
explanationstringrequired
recommendationOptional[string]
referenceOptional[string]
sourcestringrequired
changed_fieldsarray of string

diff_version

GET /security/analyses/{analysis_id}/diff/version

result = await client.analyses.diff_version(
    analysis_id=analysis_id,
)

Arguments:

analysis_idIDpathrequired
optionsVersionQueryParams | Nonequery
default:None

VersionQueryParams

version_idOptional[string]

Returns: ResultsResponse[FindingDiffItem]

show properties (1)hide properties (1)
resultsarray of FindingDiffItem
show properties (6)hide properties (6)
idstringrequired
operation'add' | 'update' | 'delete'required
reason'edit' | 'code'required
previousOptional[FindingBareSchema]
show properties (11)hide properties (11)
versionAnalysisVersionRefrequired
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
created_atstringrequired
origin_finding_idstringrequired
is_acknowledgedbooleanrequired
typestringrequired
level'critical' | 'high' | 'medium' | 'low'required
namestringrequired
explanationstringrequired
recommendationOptional[string]
referenceOptional[string]
sourcestringrequired
currentOptional[FindingBareSchema]
show properties (11)hide properties (11)
versionAnalysisVersionRefrequired
show properties (2)hide properties (2)
idstringrequired
analysis_idstringrequired
created_atstringrequired
origin_finding_idstringrequired
is_acknowledgedbooleanrequired
typestringrequired
level'critical' | 'high' | 'medium' | 'low'required
namestringrequired
explanationstringrequired
recommendationOptional[string]
referenceOptional[string]
sourcestringrequired
changed_fieldsarray of string

run

POST /security/analyses/{analysis_id}/run

result = await client.analyses.run(
    analysis_id=analysis_id,
)

Arguments:

analysis_idIDpathrequired
bodyRunAnalysisBodyDict | Nonebody
default:None
with_streamingboolbody
default:False

Return type by call:

  • with_streaming=True → EventResource[AnalysisSchema, AnalysisRunStatusEventData]
  • with_streaming=False → 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

retry

POST /security/analyses/{analysis_id}/retry

result = await client.analyses.retry(
    analysis_id=analysis_id,
)

Arguments:

analysis_idIDpathrequired
bodyVersionBodyDict | Nonebody
default:None

VersionBodyDict

version_idOptional[string]
with_streamingboolbody
default:False

Return type by call:

  • with_streaming=True → EventResource[AnalysisSchema, AnalysisRunStatusEventData]
  • with_streaming=False → 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

Scoped access

Calling client.analyses(analysis_id) returns a resource scoped to that analysis, exposing the same nested resources listed here (.remediations, .versions, .summary) pre-bound to it.

On this page