Codes

Python SDK reference for the codes resource

Note

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

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

list

GET /graph/codes

result = await client.codes.list()

Arguments:

optionsCodeQueryParams | Nonequery
default:None

CodeQueryParams

pageOptional[integer]
page_sizeOptional[integer]
order_byOptional['created_at' | 'updated_at']
orderOptional['desc' | 'asc']
user_idOptional[string]
project_idOptional[string]
project_slugOptional[string]
networkOptional['eth' | 'bsc' | 'polygon' | 'base' | 'avax' | 'mode' | 'arb' | 'eth_sepolia' | 'bsc_test' | 'polygon_amoy' | 'base_sepolia' | 'avax_fuji' | 'mode_testnet' | 'arb_sepolia' | string]
statusOptional['queued' | 'processing' | 'failed' | 'success']
identifierOptional[string]
with_paginationboolquery
default:False

Return type by call:

  • with_pagination=True → PaginatedResource[CodeMappingSchema]
  • with_pagination=False → Pagination[CodeMappingSchema]
show properties (6)hide properties (6)
resultsarray of CodeMappingSchema
show properties (13)hide properties (13)
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
created_atstringrequired
project_idstringrequired
project_slugstringrequired
userUserSchemarequired
show properties (4)hide properties (4)
idstringrequired
is_selfbooleanrequired
created_atstringrequired
usernamestringrequired
pageintegerrequired
page_sizeintegerrequired
morebooleanrequired
total_observationsintegerrequired
total_pagesintegerrequired

get

GET /graph/codes/{code_id}

result = await client.codes.get(
    code_id=code_id,
)

Arguments:

code_idIDpathrequired

Returns: CodeMappingSchema

show properties (13)hide properties (13)
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
created_atstringrequired
project_idstringrequired
project_slugstringrequired
userUserSchemarequired
show properties (4)hide properties (4)
idstringrequired
is_selfbooleanrequired
created_atstringrequired
usernamestringrequired

transitions

result = await client.codes.transitions(
    body=body,
)

Arguments:

bodyTransitionBodyDictbodyrequired

TransitionBodyDict

from_code_idstringrequired
to_code_idstringrequired

Returns: CodeVersionTransitionSchema

show properties (3)hide properties (3)
from_code_idstringrequired
to_code_idstringrequired
transitionsarray of anyrequired

edges

GET /graph/codes/{code_id}/edges

result = await client.codes.edges(
    code_id=code_id,
)

Arguments:

code_idIDpathrequired

Returns: ResultsResponse[GraphSnapshotEdge]

show properties (1)hide properties (1)
resultsarray of GraphSnapshotEdge
show properties (16)hide properties (16)
idstringrequired
src_idstringrequired
dst_idOptional[string]
short_src_idstringrequired
short_dst_idOptional[string]
edge_type'uses' | 'typed_as' | 'modified_by' | 'calls' | 'calls_external' | 'reads' | 'writes' | 'inherits' | 'overrides' | 'emits' | 'throws' | 'defines' | 'initializes' | 'instantiates' | 'accesses' | 'has_constraint' | 'has_access_control' | 'references' | 'implements' | 'extends' | 'has_ref_comment' | 'has_condition'required
src_start_posintegerrequired
call_bindingsarray of CallBinding
show properties (7)hide properties (7)
param_indexintegerrequired
param_namestringrequired
bound_to_node_idOptional[string]
bound_to_nameOptional[string]
is_known_storageboolean
type_nameOptional[string]
bound_to_fieldOptional[string]
src_field_namesarray of string
dst_field_namesarray of string
directionOptional['in' | 'out']
is_conditionalbooleanrequired
invoked_by_idOptional[string]
low_level_nameOptional[string]
src_node_typestringrequired
dst_node_typeOptional[string]

update

PATCH /graph/codes/{code_id}

result = await client.codes.update(
    code_id=code_id,
    name=name,
)

Arguments:

code_idIDpathrequired
namestrbodyrequired

Returns: CodeMappingSchema

show properties (13)hide properties (13)
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
created_atstringrequired
project_idstringrequired
project_slugstringrequired
userUserSchemarequired
show properties (4)hide properties (4)
idstringrequired
is_selfbooleanrequired
created_atstringrequired
usernamestringrequired

retry

POST /graph/codes/{code_id}/retry

result = await client.codes.retry(
    code_id=code_id,
)

Arguments:

code_idIDpathrequired

Returns: CodeMappingSchema

show properties (13)hide properties (13)
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
created_atstringrequired
project_idstringrequired
project_slugstringrequired
userUserSchemarequired
show properties (4)hide properties (4)
idstringrequired
is_selfbooleanrequired
created_atstringrequired
usernamestringrequired

create_scan

POST /graph/codes/scan

result = await client.codes.create_scan(
    body=body,
)

Arguments:

bodyCodeScanBodyDictbodyrequired

CodeScanBodyDict

project_idstringrequired
networkOptional[string]
addressstringrequired

Returns: CodeMappingSchema

show properties (13)hide properties (13)
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
created_atstringrequired
project_idstringrequired
project_slugstringrequired
userUserSchemarequired
show properties (4)hide properties (4)
idstringrequired
is_selfbooleanrequired
created_atstringrequired
usernamestringrequired

create_paste

POST /graph/codes/paste

result = await client.codes.create_paste(
    body=body,
)

Arguments:

bodyCodePasteBodyDictbodyrequired

CodePasteBodyDict

project_idstringrequired
contentstringrequired

Returns: CodeMappingSchema

show properties (13)hide properties (13)
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
created_atstringrequired
project_idstringrequired
project_slugstringrequired
userUserSchemarequired
show properties (4)hide properties (4)
idstringrequired
is_selfbooleanrequired
created_atstringrequired
usernamestringrequired

create_public_repo

POST /graph/codes/repo

result = await client.codes.create_public_repo(
    body=body,
)

Arguments:

bodyCodePublicRepoBodyDictbodyrequired

CodePublicRepoBodyDict

project_idstringrequired
urlstringrequired

Returns: CodeMappingSchema

show properties (13)hide properties (13)
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
created_atstringrequired
project_idstringrequired
project_slugstringrequired
userUserSchemarequired
show properties (4)hide properties (4)
idstringrequired
is_selfbooleanrequired
created_atstringrequired
usernamestringrequired

create_connected_repo

POST /graph/codes/connected-repo

result = await client.codes.create_connected_repo(
    body=body,
)

Arguments:

bodyCodeConnectedRepoBodyDictbodyrequired

CodeConnectedRepoBodyDict

project_idstringrequired
branchOptional[string]
commit_shaOptional[string]

Returns: CodeMappingSchema

show properties (13)hide properties (13)
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
created_atstringrequired
project_idstringrequired
project_slugstringrequired
userUserSchemarequired
show properties (4)hide properties (4)
idstringrequired
is_selfbooleanrequired
created_atstringrequired
usernamestringrequired

generate_signing_key

POST /graph/codes/signing-key

result = await client.codes.generate_signing_key(
    project_id=project_id,
)

Arguments:

project_idIDbodyrequired

Returns: str

create_file

POST /graph/codes/file

result = await client.codes.create_file(
    project_id=project_id,
    files=files,
)

Arguments:

project_idIDbodyrequired
filesList[tuple[str, bytes]]bodyrequired

Returns: CodeMappingSchema

show properties (13)hide properties (13)
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
created_atstringrequired
project_idstringrequired
project_slugstringrequired
userUserSchemarequired
show properties (4)hide properties (4)
idstringrequired
is_selfbooleanrequired
created_atstringrequired
usernamestringrequired

upload_folder_zip

POST /graph/codes/folder

result = await client.codes.upload_folder_zip(
    signing_key=signing_key,
    zip_bytes=zip_bytes,
)

Arguments:

signing_keystrbodyrequired
zip_bytesbytesbodyrequired
with_streamingboolbody
default:False

Return type by call:

  • with_streaming=True → EventResource[CodeMappingSchema, CodeStatusEventData]
  • with_streaming=False → CodeMappingSchema
show properties (13)hide properties (13)
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
created_atstringrequired
project_idstringrequired
project_slugstringrequired
userUserSchemarequired
show properties (4)hide properties (4)
idstringrequired
is_selfbooleanrequired
created_atstringrequired
usernamestringrequired

create_chat

POST /chats

result = await client.codes.create_chat(
    code_id=code_id,
)

Arguments:

code_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

Scoped access

Calling client.codes(code_id) returns a resource scoped to that code, exposing the same nested resources listed here (.files, .nodes) pre-bound to it.

On this page