Analyses
Python SDK reference for the analyses resource
Note
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 | NonequeryNoneAnalysesQueryParams
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_paginationboolqueryFalseReturn type by call:
with_pagination=True→PaginatedResource[AnalysisSchema]with_pagination=False→Pagination[AnalysisSchema]
show properties (6)hide properties (6)
resultsarray of AnalysisSchemashow properties (9)hide properties (9)
idstringrequirednamestringrequiredcreated_atstringrequireduserUserSchemarequiredshow properties (4)hide properties (4)
idstringrequiredis_selfbooleanrequiredcreated_atstringrequiredusernamestringrequiredproject_idstringrequiredproject_namestringrequiredproject_slugstringrequiredis_ownerbooleanrequiredversionAnalysisVersionSchemarequiredshow properties (16)hide properties (16)
idstringrequiredcreated_atstringrequiredtrigger'create' | 'commit' | 'fork' | 'merge' | 'push'requiredn_findingsintegerrequiredn_remediationsintegerrequiredis_headbooleanrequiredhas_pipeline_processingbooleanrequiredhas_pipeline_failedbooleanrequiredcode_versionCodeVersionSchemarequiredshow properties (9)hide properties (9)
idstringrequirednetworkOptional['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'requiredversion_fingerprintstringrequiredstatus'queued' | 'processing' | 'failed' | 'success'requirednameOptional[string]branchOptional[string]commitOptional[GithubCommitSchema]show properties (4)hide properties (4)
shastringrequiredauthorstringrequiredmessagestringrequiredtimestampstringrequiredrepositoryOptional[GithubRepositorySchema]show properties (4)hide properties (4)
idintegerrequirednamestringrequiredis_privatebooleanrequiredaccountGithubAccountSchemarequiredshow properties (4)hide properties (4)
idintegerrequiredloginstringrequiredtypestringrequiredavatar_urlstringrequiredmerged_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredparent_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredchild_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredmerged_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredactionsAnalysisActionsrequiredshow properties (10)hide properties (10)
can_forkbooleanrequiredcan_create_childbooleanrequiredcan_commit_changesbooleanrequiredcan_deletebooleanrequiredcan_run_pipelinebooleanrequiredcan_retry_pipelinebooleanrequiredcan_merge_tobooleanrequiredcan_merge_frombooleanrequiredcan_stage_changesbooleanrequiredcan_set_as_headbooleanrequiredpageintegerrequiredpage_sizeintegerrequiredmorebooleanrequiredtotal_observationsintegerrequiredtotal_pagesintegerrequiredget
GET /security/analyses/{analysis_id}
result = await client.analyses.get(
analysis_id=analysis_id,
)Arguments:
analysis_idIDpathrequiredoptionsVersionQueryParams | NonequeryNoneVersionQueryParams
version_idOptional[string]Returns: AnalysisSchema
show properties (9)hide properties (9)
idstringrequirednamestringrequiredcreated_atstringrequireduserUserSchemarequiredshow properties (4)hide properties (4)
idstringrequiredis_selfbooleanrequiredcreated_atstringrequiredusernamestringrequiredproject_idstringrequiredproject_namestringrequiredproject_slugstringrequiredis_ownerbooleanrequiredversionAnalysisVersionSchemarequiredshow properties (16)hide properties (16)
idstringrequiredcreated_atstringrequiredtrigger'create' | 'commit' | 'fork' | 'merge' | 'push'requiredn_findingsintegerrequiredn_remediationsintegerrequiredis_headbooleanrequiredhas_pipeline_processingbooleanrequiredhas_pipeline_failedbooleanrequiredcode_versionCodeVersionSchemarequiredshow properties (9)hide properties (9)
idstringrequirednetworkOptional['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'requiredversion_fingerprintstringrequiredstatus'queued' | 'processing' | 'failed' | 'success'requirednameOptional[string]branchOptional[string]commitOptional[GithubCommitSchema]show properties (4)hide properties (4)
shastringrequiredauthorstringrequiredmessagestringrequiredtimestampstringrequiredrepositoryOptional[GithubRepositorySchema]show properties (4)hide properties (4)
idintegerrequirednamestringrequiredis_privatebooleanrequiredaccountGithubAccountSchemarequiredshow properties (4)hide properties (4)
idintegerrequiredloginstringrequiredtypestringrequiredavatar_urlstringrequiredmerged_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredparent_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredchild_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredmerged_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredactionsAnalysisActionsrequiredshow properties (10)hide properties (10)
can_forkbooleanrequiredcan_create_childbooleanrequiredcan_commit_changesbooleanrequiredcan_deletebooleanrequiredcan_run_pipelinebooleanrequiredcan_retry_pipelinebooleanrequiredcan_merge_tobooleanrequiredcan_merge_frombooleanrequiredcan_stage_changesbooleanrequiredcan_set_as_headbooleanrequiredrecent
GET /security/analyses/recent
result = await client.analyses.recent()Arguments:
optionsLatestQueryParams | NonequeryNoneLatestQueryParams
project_idOptional[string]project_slugOptional[string]Returns: ExistsResponse[AnalysisExpandedSchema]
show properties (2)hide properties (2)
existsbooleanrequireddataOptional[AnalysisExpandedSchema]show properties (10)hide properties (10)
idstringrequirednamestringrequiredcreated_atstringrequireduserUserSchemarequiredshow properties (4)hide properties (4)
idstringrequiredis_selfbooleanrequiredcreated_atstringrequiredusernamestringrequiredproject_idstringrequiredproject_namestringrequiredproject_slugstringrequiredis_ownerbooleanrequiredversionAnalysisVersionSchemarequiredshow properties (16)hide properties (16)
idstringrequiredcreated_atstringrequiredtrigger'create' | 'commit' | 'fork' | 'merge' | 'push'requiredn_findingsintegerrequiredn_remediationsintegerrequiredis_headbooleanrequiredhas_pipeline_processingbooleanrequiredhas_pipeline_failedbooleanrequiredcode_versionCodeVersionSchemarequiredshow properties (9)hide properties (9)
idstringrequirednetworkOptional['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'requiredversion_fingerprintstringrequiredstatus'queued' | 'processing' | 'failed' | 'success'requirednameOptional[string]branchOptional[string]commitOptional[GithubCommitSchema]show properties (4)hide properties (4)
shastringrequiredauthorstringrequiredmessagestringrequiredtimestampstringrequiredrepositoryOptional[GithubRepositorySchema]show properties (4)hide properties (4)
idintegerrequirednamestringrequiredis_privatebooleanrequiredaccountGithubAccountSchemarequiredshow properties (4)hide properties (4)
idintegerrequiredloginstringrequiredtypestringrequiredavatar_urlstringrequiredmerged_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredparent_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredchild_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredmerged_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredactionsAnalysisActionsrequiredshow properties (10)hide properties (10)
can_forkbooleanrequiredcan_create_childbooleanrequiredcan_commit_changesbooleanrequiredcan_deletebooleanrequiredcan_run_pipelinebooleanrequiredcan_retry_pipelinebooleanrequiredcan_merge_tobooleanrequiredcan_merge_frombooleanrequiredcan_stage_changesbooleanrequiredcan_set_as_headbooleanrequiredfindingsarray of FindingSchemashow properties (21)hide properties (21)
versionAnalysisVersionRefrequiredshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredcreated_atstringrequiredorigin_finding_idstringrequiredis_acknowledgedbooleanrequiredtypestringrequiredlevel'critical' | 'high' | 'medium' | 'low'requirednamestringrequiredexplanationstringrequiredrecommendationOptional[string]referenceOptional[string]sourcestringrequiredidstringrequirednode_idstringrequiredis_borrowedbooleanrequiredlocation_idOptional[string]created_by_userUserSchemarequiredshow properties (4)hide properties (4)
idstringrequiredis_selfbooleanrequiredcreated_atstringrequiredusernamestringrequiredproject_idstringrequiredproject_slugstringrequiredcode_idstringrequiredoperationOptional['add' | 'update' | 'delete']actionsFindingActionsrequiredshow properties (3)hide properties (3)
can_editbooleanrequiredcan_revertbooleanrequiredcan_deletebooleanrequiredupdate
PATCH /security/analyses/{analysis_id}
result = await client.analyses.update(
analysis_id=analysis_id,
name=name,
)Arguments:
analysis_idIDpathrequirednamestrbodyrequiredReturns: AnalysisSchema
show properties (9)hide properties (9)
idstringrequirednamestringrequiredcreated_atstringrequireduserUserSchemarequiredshow properties (4)hide properties (4)
idstringrequiredis_selfbooleanrequiredcreated_atstringrequiredusernamestringrequiredproject_idstringrequiredproject_namestringrequiredproject_slugstringrequiredis_ownerbooleanrequiredversionAnalysisVersionSchemarequiredshow properties (16)hide properties (16)
idstringrequiredcreated_atstringrequiredtrigger'create' | 'commit' | 'fork' | 'merge' | 'push'requiredn_findingsintegerrequiredn_remediationsintegerrequiredis_headbooleanrequiredhas_pipeline_processingbooleanrequiredhas_pipeline_failedbooleanrequiredcode_versionCodeVersionSchemarequiredshow properties (9)hide properties (9)
idstringrequirednetworkOptional['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'requiredversion_fingerprintstringrequiredstatus'queued' | 'processing' | 'failed' | 'success'requirednameOptional[string]branchOptional[string]commitOptional[GithubCommitSchema]show properties (4)hide properties (4)
shastringrequiredauthorstringrequiredmessagestringrequiredtimestampstringrequiredrepositoryOptional[GithubRepositorySchema]show properties (4)hide properties (4)
idintegerrequirednamestringrequiredis_privatebooleanrequiredaccountGithubAccountSchemarequiredshow properties (4)hide properties (4)
idintegerrequiredloginstringrequiredtypestringrequiredavatar_urlstringrequiredmerged_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredparent_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredchild_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredmerged_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredactionsAnalysisActionsrequiredshow properties (10)hide properties (10)
can_forkbooleanrequiredcan_create_childbooleanrequiredcan_commit_changesbooleanrequiredcan_deletebooleanrequiredcan_run_pipelinebooleanrequiredcan_retry_pipelinebooleanrequiredcan_merge_tobooleanrequiredcan_merge_frombooleanrequiredcan_stage_changesbooleanrequiredcan_set_as_headbooleanrequireddelete
DELETE /security/analyses/{analysis_id}
result = await client.analyses.delete(
analysis_id=analysis_id,
)Arguments:
analysis_idIDpathrequiredReturns: BooleanResponse
show properties (1)hide properties (1)
successbooleanrequiredcreate_root
POST /security/analyses
result = await client.analyses.create_root(
body=body,
)Arguments:
bodyCreateAnalysisRootBodyDictbodyrequiredCreateAnalysisRootBodyDict
code_idstringrequiredon_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_idIDpathrequiredbodyCreateAnalysisChildBodyDictbodyrequiredCreateAnalysisChildBodyDict
code_idstringrequiredon_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_idIDpathrequiredbodyVersionBodyDict | NonebodyNoneVersionBodyDict
version_idOptional[string]Returns: AnalysisSchema
show properties (9)hide properties (9)
idstringrequirednamestringrequiredcreated_atstringrequireduserUserSchemarequiredshow properties (4)hide properties (4)
idstringrequiredis_selfbooleanrequiredcreated_atstringrequiredusernamestringrequiredproject_idstringrequiredproject_namestringrequiredproject_slugstringrequiredis_ownerbooleanrequiredversionAnalysisVersionSchemarequiredshow properties (16)hide properties (16)
idstringrequiredcreated_atstringrequiredtrigger'create' | 'commit' | 'fork' | 'merge' | 'push'requiredn_findingsintegerrequiredn_remediationsintegerrequiredis_headbooleanrequiredhas_pipeline_processingbooleanrequiredhas_pipeline_failedbooleanrequiredcode_versionCodeVersionSchemarequiredshow properties (9)hide properties (9)
idstringrequirednetworkOptional['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'requiredversion_fingerprintstringrequiredstatus'queued' | 'processing' | 'failed' | 'success'requirednameOptional[string]branchOptional[string]commitOptional[GithubCommitSchema]show properties (4)hide properties (4)
shastringrequiredauthorstringrequiredmessagestringrequiredtimestampstringrequiredrepositoryOptional[GithubRepositorySchema]show properties (4)hide properties (4)
idintegerrequirednamestringrequiredis_privatebooleanrequiredaccountGithubAccountSchemarequiredshow properties (4)hide properties (4)
idintegerrequiredloginstringrequiredtypestringrequiredavatar_urlstringrequiredmerged_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredparent_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredchild_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredmerged_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredactionsAnalysisActionsrequiredshow properties (10)hide properties (10)
can_forkbooleanrequiredcan_create_childbooleanrequiredcan_commit_changesbooleanrequiredcan_deletebooleanrequiredcan_run_pipelinebooleanrequiredcan_retry_pipelinebooleanrequiredcan_merge_tobooleanrequiredcan_merge_frombooleanrequiredcan_stage_changesbooleanrequiredcan_set_as_headbooleanrequiredmerge
POST /security/merge
result = await client.analyses.merge(
body=body,
)Arguments:
bodyMergeAnalysisBodyDictbodyrequiredMergeAnalysisBodyDict
from_version_idstringrequiredto_version_idstringrequiredReturns: AnalysisSchema
show properties (9)hide properties (9)
idstringrequirednamestringrequiredcreated_atstringrequireduserUserSchemarequiredshow properties (4)hide properties (4)
idstringrequiredis_selfbooleanrequiredcreated_atstringrequiredusernamestringrequiredproject_idstringrequiredproject_namestringrequiredproject_slugstringrequiredis_ownerbooleanrequiredversionAnalysisVersionSchemarequiredshow properties (16)hide properties (16)
idstringrequiredcreated_atstringrequiredtrigger'create' | 'commit' | 'fork' | 'merge' | 'push'requiredn_findingsintegerrequiredn_remediationsintegerrequiredis_headbooleanrequiredhas_pipeline_processingbooleanrequiredhas_pipeline_failedbooleanrequiredcode_versionCodeVersionSchemarequiredshow properties (9)hide properties (9)
idstringrequirednetworkOptional['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'requiredversion_fingerprintstringrequiredstatus'queued' | 'processing' | 'failed' | 'success'requirednameOptional[string]branchOptional[string]commitOptional[GithubCommitSchema]show properties (4)hide properties (4)
shastringrequiredauthorstringrequiredmessagestringrequiredtimestampstringrequiredrepositoryOptional[GithubRepositorySchema]show properties (4)hide properties (4)
idintegerrequirednamestringrequiredis_privatebooleanrequiredaccountGithubAccountSchemarequiredshow properties (4)hide properties (4)
idintegerrequiredloginstringrequiredtypestringrequiredavatar_urlstringrequiredmerged_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredparent_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredchild_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredmerged_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredactionsAnalysisActionsrequiredshow properties (10)hide properties (10)
can_forkbooleanrequiredcan_create_childbooleanrequiredcan_commit_changesbooleanrequiredcan_deletebooleanrequiredcan_run_pipelinebooleanrequiredcan_retry_pipelinebooleanrequiredcan_merge_tobooleanrequiredcan_merge_frombooleanrequiredcan_stage_changesbooleanrequiredcan_set_as_headbooleanrequiredcommit
POST /security/analyses/{analysis_id}/commit
result = await client.analyses.commit(
analysis_id=analysis_id,
)Arguments:
analysis_idIDpathrequiredbodyVersionBodyDict | NonebodyNoneVersionBodyDict
version_idOptional[string]Returns: AnalysisSchema
show properties (9)hide properties (9)
idstringrequirednamestringrequiredcreated_atstringrequireduserUserSchemarequiredshow properties (4)hide properties (4)
idstringrequiredis_selfbooleanrequiredcreated_atstringrequiredusernamestringrequiredproject_idstringrequiredproject_namestringrequiredproject_slugstringrequiredis_ownerbooleanrequiredversionAnalysisVersionSchemarequiredshow properties (16)hide properties (16)
idstringrequiredcreated_atstringrequiredtrigger'create' | 'commit' | 'fork' | 'merge' | 'push'requiredn_findingsintegerrequiredn_remediationsintegerrequiredis_headbooleanrequiredhas_pipeline_processingbooleanrequiredhas_pipeline_failedbooleanrequiredcode_versionCodeVersionSchemarequiredshow properties (9)hide properties (9)
idstringrequirednetworkOptional['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'requiredversion_fingerprintstringrequiredstatus'queued' | 'processing' | 'failed' | 'success'requirednameOptional[string]branchOptional[string]commitOptional[GithubCommitSchema]show properties (4)hide properties (4)
shastringrequiredauthorstringrequiredmessagestringrequiredtimestampstringrequiredrepositoryOptional[GithubRepositorySchema]show properties (4)hide properties (4)
idintegerrequirednamestringrequiredis_privatebooleanrequiredaccountGithubAccountSchemarequiredshow properties (4)hide properties (4)
idintegerrequiredloginstringrequiredtypestringrequiredavatar_urlstringrequiredmerged_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredparent_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredchild_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredmerged_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredactionsAnalysisActionsrequiredshow properties (10)hide properties (10)
can_forkbooleanrequiredcan_create_childbooleanrequiredcan_commit_changesbooleanrequiredcan_deletebooleanrequiredcan_run_pipelinebooleanrequiredcan_retry_pipelinebooleanrequiredcan_merge_tobooleanrequiredcan_merge_frombooleanrequiredcan_stage_changesbooleanrequiredcan_set_as_headbooleanrequiredset_head
POST /security/analyses/{version_id}/head
result = await client.analyses.set_head(
analysis_id=analysis_id,
body=body,
)Arguments:
analysis_idIDbodyrequiredbodySetHeadBodyDictbodyrequiredSetHeadBodyDict
version_idstringrequiredReturns: AnalysisSchema
show properties (9)hide properties (9)
idstringrequirednamestringrequiredcreated_atstringrequireduserUserSchemarequiredshow properties (4)hide properties (4)
idstringrequiredis_selfbooleanrequiredcreated_atstringrequiredusernamestringrequiredproject_idstringrequiredproject_namestringrequiredproject_slugstringrequiredis_ownerbooleanrequiredversionAnalysisVersionSchemarequiredshow properties (16)hide properties (16)
idstringrequiredcreated_atstringrequiredtrigger'create' | 'commit' | 'fork' | 'merge' | 'push'requiredn_findingsintegerrequiredn_remediationsintegerrequiredis_headbooleanrequiredhas_pipeline_processingbooleanrequiredhas_pipeline_failedbooleanrequiredcode_versionCodeVersionSchemarequiredshow properties (9)hide properties (9)
idstringrequirednetworkOptional['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'requiredversion_fingerprintstringrequiredstatus'queued' | 'processing' | 'failed' | 'success'requirednameOptional[string]branchOptional[string]commitOptional[GithubCommitSchema]show properties (4)hide properties (4)
shastringrequiredauthorstringrequiredmessagestringrequiredtimestampstringrequiredrepositoryOptional[GithubRepositorySchema]show properties (4)hide properties (4)
idintegerrequirednamestringrequiredis_privatebooleanrequiredaccountGithubAccountSchemarequiredshow properties (4)hide properties (4)
idintegerrequiredloginstringrequiredtypestringrequiredavatar_urlstringrequiredmerged_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredparent_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredchild_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredmerged_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredactionsAnalysisActionsrequiredshow properties (10)hide properties (10)
can_forkbooleanrequiredcan_create_childbooleanrequiredcan_commit_changesbooleanrequiredcan_deletebooleanrequiredcan_run_pipelinebooleanrequiredcan_retry_pipelinebooleanrequiredcan_merge_tobooleanrequiredcan_merge_frombooleanrequiredcan_stage_changesbooleanrequiredcan_set_as_headbooleanrequiredentrypoints
GET /security/analyses/{analysis_id}/entrypoints
result = await client.analyses.entrypoints(
analysis_id=analysis_id,
)Arguments:
analysis_idIDpathrequiredoptionsVersionQueryParams | NonequeryNoneVersionQueryParams
version_idOptional[string]Returns: ResultsResponse[EntryPointSchema]
show properties (1)hide properties (1)
resultsarray of EntryPointSchemashow properties (6)hide properties (6)
nodeGraphSnapshotNoderequiredshow properties (23)hide properties (23)
idstringrequiredfile_idstringrequiredfile_pathstringrequiredshort_idstringrequirednode_typestringrequiredsub_typeOptional[string]src_start_posintegerrequiredsrc_end_posintegerrequiredpathstringrequireddocstringOptional[string]namestringrequiredmerkle_hashstringrequiredvisibilityOptional['external' | 'public' | 'internal' | 'private']mutabilityOptional[string]is_virtualbooleanis_implementedbooleansignatureOptional[string]is_callablebooleanrequiredis_declarationbooleanrequiredis_containerbooleanrequiredis_entrypointbooleanrequiredfieldsarray of FieldMetadataItemshow properties (6)hide properties (6)
namestringrequiredtypeOptional[string]valueOptional[string]mutabilityOptional[string]discriminantOptional[integer]constraintsarray of ConstraintItemshow properties (2)hide properties (2)
namestringrequiredvalueOptional[array of string]parametersarray of ParameterStorageMetadatashow properties (7)hide properties (7)
param_indexintegerrequiredstart_byteintegerrequiredis_readbooleanis_writtenbooleanfieldOptional[string]param_nameOptional[string]type_nameOptional[string]is_analyzedbooleanrequiredis_inheritedbooleanrequiredis_analyzed_in_currentbooleanrequiredpipeline_status'not_run' | 'queued' | 'processing' | 'success' | 'failed'requiredn_findingsintegerlist_findings
GET /security/analyses/{analysis_id}/findings
result = await client.analyses.list_findings(
analysis_id=analysis_id,
)Arguments:
analysis_idIDpathrequiredoptionsVersionQueryParams | NonequeryNoneVersionQueryParams
version_idOptional[string]Returns: ResultsResponse[FindingSchema]
show properties (1)hide properties (1)
resultsarray of FindingSchemashow properties (21)hide properties (21)
versionAnalysisVersionRefrequiredshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredcreated_atstringrequiredorigin_finding_idstringrequiredis_acknowledgedbooleanrequiredtypestringrequiredlevel'critical' | 'high' | 'medium' | 'low'requirednamestringrequiredexplanationstringrequiredrecommendationOptional[string]referenceOptional[string]sourcestringrequiredidstringrequirednode_idstringrequiredis_borrowedbooleanrequiredlocation_idOptional[string]created_by_userUserSchemarequiredshow properties (4)hide properties (4)
idstringrequiredis_selfbooleanrequiredcreated_atstringrequiredusernamestringrequiredproject_idstringrequiredproject_slugstringrequiredcode_idstringrequiredoperationOptional['add' | 'update' | 'delete']actionsFindingActionsrequiredshow properties (3)hide properties (3)
can_editbooleanrequiredcan_revertbooleanrequiredcan_deletebooleanrequiredadd_findings
POST /security/analyses/{analysis_id}/findings
result = await client.analyses.add_findings(
analysis_id=analysis_id,
body=body,
)Arguments:
analysis_idIDpathrequiredbodyAddFindingBodyDictbodyrequiredAddFindingBodyDict
version_idOptional[string]findingsarray of FindingBodyDictrequiredFindingBodyDict
sourceOptional[string]metadataOptional[FindingMetadataDict]FindingMetadataDict
typestringrequiredlevel'critical' | 'high' | 'medium' | 'low'requirednamestringrequiredexplanationstringrequiredrecommendationOptional[string]referenceOptional[string]locationFindingLocationNodeIdDict | FindingLocationPhysicalDict | FindingLocationLogicalDictrequiredFindingLocationNodeIdDict
strategystringrequirednode_idOptional[string]location_idOptional[string]FindingLocationPhysicalDict
strategystringrequireduristringrequiredstartLineOptional[integer]startColumnOptional[integer]endLineOptional[integer]endColumnOptional[integer]charOffsetOptional[integer]charLengthOptional[integer]byteOffsetOptional[integer]byteLengthOptional[integer]FindingLocationLogicalDict
strategystringrequiredfully_qualified_namestringrequiredReturns: ResultsResponse[FindingSchema]
show properties (1)hide properties (1)
resultsarray of FindingSchemashow properties (21)hide properties (21)
versionAnalysisVersionRefrequiredshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredcreated_atstringrequiredorigin_finding_idstringrequiredis_acknowledgedbooleanrequiredtypestringrequiredlevel'critical' | 'high' | 'medium' | 'low'requirednamestringrequiredexplanationstringrequiredrecommendationOptional[string]referenceOptional[string]sourcestringrequiredidstringrequirednode_idstringrequiredis_borrowedbooleanrequiredlocation_idOptional[string]created_by_userUserSchemarequiredshow properties (4)hide properties (4)
idstringrequiredis_selfbooleanrequiredcreated_atstringrequiredusernamestringrequiredproject_idstringrequiredproject_slugstringrequiredcode_idstringrequiredoperationOptional['add' | 'update' | 'delete']actionsFindingActionsrequiredshow properties (3)hide properties (3)
can_editbooleanrequiredcan_revertbooleanrequiredcan_deletebooleanrequireddiff_staged
GET /security/analyses/{analysis_id}/diff/staged
result = await client.analyses.diff_staged(
analysis_id=analysis_id,
)Arguments:
analysis_idIDpathrequiredoptionsVersionQueryParams | NonequeryNoneVersionQueryParams
version_idOptional[string]Returns: ResultsResponse[FindingDiffItem]
show properties (1)hide properties (1)
resultsarray of FindingDiffItemshow properties (6)hide properties (6)
idstringrequiredoperation'add' | 'update' | 'delete'requiredreason'edit' | 'code'requiredpreviousOptional[FindingBareSchema]show properties (11)hide properties (11)
versionAnalysisVersionRefrequiredshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredcreated_atstringrequiredorigin_finding_idstringrequiredis_acknowledgedbooleanrequiredtypestringrequiredlevel'critical' | 'high' | 'medium' | 'low'requirednamestringrequiredexplanationstringrequiredrecommendationOptional[string]referenceOptional[string]sourcestringrequiredcurrentOptional[FindingBareSchema]show properties (11)hide properties (11)
versionAnalysisVersionRefrequiredshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredcreated_atstringrequiredorigin_finding_idstringrequiredis_acknowledgedbooleanrequiredtypestringrequiredlevel'critical' | 'high' | 'medium' | 'low'requirednamestringrequiredexplanationstringrequiredrecommendationOptional[string]referenceOptional[string]sourcestringrequiredchanged_fieldsarray of stringdiff_version
GET /security/analyses/{analysis_id}/diff/version
result = await client.analyses.diff_version(
analysis_id=analysis_id,
)Arguments:
analysis_idIDpathrequiredoptionsVersionQueryParams | NonequeryNoneVersionQueryParams
version_idOptional[string]Returns: ResultsResponse[FindingDiffItem]
show properties (1)hide properties (1)
resultsarray of FindingDiffItemshow properties (6)hide properties (6)
idstringrequiredoperation'add' | 'update' | 'delete'requiredreason'edit' | 'code'requiredpreviousOptional[FindingBareSchema]show properties (11)hide properties (11)
versionAnalysisVersionRefrequiredshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredcreated_atstringrequiredorigin_finding_idstringrequiredis_acknowledgedbooleanrequiredtypestringrequiredlevel'critical' | 'high' | 'medium' | 'low'requirednamestringrequiredexplanationstringrequiredrecommendationOptional[string]referenceOptional[string]sourcestringrequiredcurrentOptional[FindingBareSchema]show properties (11)hide properties (11)
versionAnalysisVersionRefrequiredshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredcreated_atstringrequiredorigin_finding_idstringrequiredis_acknowledgedbooleanrequiredtypestringrequiredlevel'critical' | 'high' | 'medium' | 'low'requirednamestringrequiredexplanationstringrequiredrecommendationOptional[string]referenceOptional[string]sourcestringrequiredchanged_fieldsarray of stringrun
POST /security/analyses/{analysis_id}/run
result = await client.analyses.run(
analysis_id=analysis_id,
)Arguments:
analysis_idIDpathrequiredbodyRunAnalysisBodyDict | NonebodyNonewith_streamingboolbodyFalseReturn type by call:
with_streaming=True→EventResource[AnalysisSchema, AnalysisRunStatusEventData]with_streaming=False→AnalysisSchema
show properties (9)hide properties (9)
idstringrequirednamestringrequiredcreated_atstringrequireduserUserSchemarequiredshow properties (4)hide properties (4)
idstringrequiredis_selfbooleanrequiredcreated_atstringrequiredusernamestringrequiredproject_idstringrequiredproject_namestringrequiredproject_slugstringrequiredis_ownerbooleanrequiredversionAnalysisVersionSchemarequiredshow properties (16)hide properties (16)
idstringrequiredcreated_atstringrequiredtrigger'create' | 'commit' | 'fork' | 'merge' | 'push'requiredn_findingsintegerrequiredn_remediationsintegerrequiredis_headbooleanrequiredhas_pipeline_processingbooleanrequiredhas_pipeline_failedbooleanrequiredcode_versionCodeVersionSchemarequiredshow properties (9)hide properties (9)
idstringrequirednetworkOptional['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'requiredversion_fingerprintstringrequiredstatus'queued' | 'processing' | 'failed' | 'success'requirednameOptional[string]branchOptional[string]commitOptional[GithubCommitSchema]show properties (4)hide properties (4)
shastringrequiredauthorstringrequiredmessagestringrequiredtimestampstringrequiredrepositoryOptional[GithubRepositorySchema]show properties (4)hide properties (4)
idintegerrequirednamestringrequiredis_privatebooleanrequiredaccountGithubAccountSchemarequiredshow properties (4)hide properties (4)
idintegerrequiredloginstringrequiredtypestringrequiredavatar_urlstringrequiredmerged_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredparent_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredchild_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredmerged_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredactionsAnalysisActionsrequiredshow properties (10)hide properties (10)
can_forkbooleanrequiredcan_create_childbooleanrequiredcan_commit_changesbooleanrequiredcan_deletebooleanrequiredcan_run_pipelinebooleanrequiredcan_retry_pipelinebooleanrequiredcan_merge_tobooleanrequiredcan_merge_frombooleanrequiredcan_stage_changesbooleanrequiredcan_set_as_headbooleanrequiredretry
POST /security/analyses/{analysis_id}/retry
result = await client.analyses.retry(
analysis_id=analysis_id,
)Arguments:
analysis_idIDpathrequiredbodyVersionBodyDict | NonebodyNoneVersionBodyDict
version_idOptional[string]with_streamingboolbodyFalseReturn type by call:
with_streaming=True→EventResource[AnalysisSchema, AnalysisRunStatusEventData]with_streaming=False→AnalysisSchema
show properties (9)hide properties (9)
idstringrequirednamestringrequiredcreated_atstringrequireduserUserSchemarequiredshow properties (4)hide properties (4)
idstringrequiredis_selfbooleanrequiredcreated_atstringrequiredusernamestringrequiredproject_idstringrequiredproject_namestringrequiredproject_slugstringrequiredis_ownerbooleanrequiredversionAnalysisVersionSchemarequiredshow properties (16)hide properties (16)
idstringrequiredcreated_atstringrequiredtrigger'create' | 'commit' | 'fork' | 'merge' | 'push'requiredn_findingsintegerrequiredn_remediationsintegerrequiredis_headbooleanrequiredhas_pipeline_processingbooleanrequiredhas_pipeline_failedbooleanrequiredcode_versionCodeVersionSchemarequiredshow properties (9)hide properties (9)
idstringrequirednetworkOptional['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'requiredversion_fingerprintstringrequiredstatus'queued' | 'processing' | 'failed' | 'success'requirednameOptional[string]branchOptional[string]commitOptional[GithubCommitSchema]show properties (4)hide properties (4)
shastringrequiredauthorstringrequiredmessagestringrequiredtimestampstringrequiredrepositoryOptional[GithubRepositorySchema]show properties (4)hide properties (4)
idintegerrequirednamestringrequiredis_privatebooleanrequiredaccountGithubAccountSchemarequiredshow properties (4)hide properties (4)
idintegerrequiredloginstringrequiredtypestringrequiredavatar_urlstringrequiredmerged_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_from_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredparent_versionOptional[AnalysisVersionRef]show properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredchild_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredmerged_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredforked_versionsarray of AnalysisVersionRefshow properties (2)hide properties (2)
idstringrequiredanalysis_idstringrequiredactionsAnalysisActionsrequiredshow properties (10)hide properties (10)
can_forkbooleanrequiredcan_create_childbooleanrequiredcan_commit_changesbooleanrequiredcan_deletebooleanrequiredcan_run_pipelinebooleanrequiredcan_retry_pipelinebooleanrequiredcan_merge_tobooleanrequiredcan_merge_frombooleanrequiredcan_stage_changesbooleanrequiredcan_set_as_headbooleanrequiredScoped 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.

