Versions - Bevor Documentation

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

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

`create_child`

POST /security/versions/{analysis_id}/child

result = await client.versions.create_child(
    version_id=version_id,
    code_version_id=code_version_id,
)

result = client.versions.create_child(
    version_id=version_id,
    code_version_id=code_version_id,
)

Parameter	Type	Required	Default
`version_id`	`ID`	Yes	`—`
`code_version_id`	`ID`	Yes	`—`
`check_existing`	`bool \| None`	No	`None`

Returns: AnalysisCreateSchema

`get`

GET /security/versions/{version_id}

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

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

Parameter	Type	Required	Default
`version_id`	`ID`	Yes	`—`

Returns: AnalysisVersionSchema

`list`

GET /security/analyses

result = await client.versions.list()

result = client.versions.list()

Parameter	Type	Required	Default
`page`	`int \| None`	No	`None`
`page_size`	`int \| None`	No	`None`
`analysis_id`	`ID \| None`	No	`None`
`env`	`str \| None`	No	`None`
`project_id`	`ID \| None`	No	`None`
`project_slug`	`str \| None`	No	`None`
`user_id`	`ID \| None`	No	`None`
`is_owner`	`bool \| None`	No	`None`
`forked_from_version_id`	`ID \| None`	No	`None`
`merged_from_version_id`	`ID \| None`	No	`None`
`parent_version_id`	`ID \| None`	No	`None`
`trigger`	`AnalysisTrigger \| None`	No	`None`
`code_version_id`	`ID \| None`	No	`None`
`order`	`Literal['desc', 'asc'] \| None`	No	`None`

Returns: PaginatedResource[AnalysisVersionSchema]

`delete`

DELETE /security/versions/{version_id}

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

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

Parameter	Type	Required	Default
`version_id`	`ID`	Yes	`—`

Returns: AnalysisSchema

`fork`

POST /security/versions/{version_id}/fork

result = await client.versions.fork(
    version_id=version_id,
)

result = client.versions.fork(
    version_id=version_id,
)

Parameter	Type	Required	Default
`version_id`	`ID`	Yes	`—`

Returns: AnalysisSchema

`merge`

POST /security/analyses/merge

result = await client.versions.merge(
    from_version_id=from_version_id,
    to_version_id=to_version_id,
)

result = client.versions.merge(
    from_version_id=from_version_id,
    to_version_id=to_version_id,
)

Parameter	Type	Required	Default
`from_version_id`	`ID`	Yes	`—`
`to_version_id`	`ID`	Yes	`—`

Returns: AnalysisSchema

`commit`

POST /security/versions/{version_id}/commit

result = await client.versions.commit(
    version_id=version_id,
)

result = client.versions.commit(
    version_id=version_id,
)

Parameter	Type	Required	Default
`version_id`	`ID`	Yes	`—`

Returns: AnalysisSchema

`set_head`

POST /security/versions/{version_id}/head

result = await client.versions.set_head(
    version_id=version_id,
)

result = client.versions.set_head(
    version_id=version_id,
)

Parameter	Type	Required	Default
`version_id`	`ID`	Yes	`—`

Returns: AnalysisSchema

`entrypoints`

GET /security/versions/{version_id}/entrypoints

result = await client.versions.entrypoints(
    version_id=version_id,
)

result = client.versions.entrypoints(
    version_id=version_id,
)

Parameter	Type	Required	Default
`version_id`	`ID`	Yes	`—`

Returns: ResultsResponse[EntryPointSchema]

`findings`

GET /security/versions/{version_id}/findings

result = await client.versions.findings(
    version_id=version_id,
)

result = client.versions.findings(
    version_id=version_id,
)

Parameter	Type	Required	Default
`version_id`	`ID`	Yes	`—`

Returns: ResultsResponse[FindingSchema]

`diff_staged`

GET /security/versions/{version_id}/diff/staged

result = await client.versions.diff_staged(
    version_id=version_id,
)

result = client.versions.diff_staged(
    version_id=version_id,
)

Parameter	Type	Required	Default
`version_id`	`ID`	Yes	`—`

Returns: ResultsResponse[FindingDiffItem]

`diff_version`

GET /security/versions/{version_id}/diff/version

result = await client.versions.diff_version(
    version_id=version_id,
)

result = client.versions.diff_version(
    version_id=version_id,
)

Parameter	Type	Required	Default
`version_id`	`ID`	Yes	`—`

Returns: ResultsResponse[FindingDiffItem]

`run`

POST /security/versions/{version_id}/run

result = await client.versions.run(
    version_id=version_id,
)

result = client.versions.run(
    version_id=version_id,
)

Parameter	Type	Required	Default
`version_id`	`ID`	Yes	`—`
`mode`	`Literal['all', 'first_party', 'explicit'] \| None`	No	`None`
`scopes`	`List[str] \| None`	No	`None`

Returns: AnalysisVersionSchema

`retry`

POST /security/versions/{version_id}/retry

result = await client.versions.retry(
    version_id=version_id,
)

result = client.versions.retry(
    version_id=version_id,
)

Parameter	Type	Required	Default
`version_id`	`ID`	Yes	`—`

Returns: AnalysisVersionSchema

​create_child

​get

​list

​delete

​fork

​merge

​commit

​set_head

​entrypoints

​findings

​diff_staged

​diff_version

​run

​retry

`create_child`

`get`

`list`

`delete`

`fork`

`merge`

`commit`

`set_head`

`entrypoints`

`findings`

`diff_staged`

`diff_version`

`run`

`retry`