> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bevor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Versions

> Python SDK reference for the versions resource

<Note>The Bevor SDK is coming soon. This page previews its planned Python interface.</Note>

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

## `create_child`

POST `/security/versions/{analysis_id}/child`

<CodeGroup>
  ```python Async theme={null}
  result = await client.versions.create_child(
      version_id=version_id,
      code_version_id=code_version_id,
  )
  ```

  ```python Sync theme={null}
  result = client.versions.create_child(
      version_id=version_id,
      code_version_id=code_version_id,
  )
  ```
</CodeGroup>

| 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}`

<CodeGroup>
  ```python Async theme={null}
  result = await client.versions.get(
      version_id=version_id,
  )
  ```

  ```python Sync theme={null}
  result = client.versions.get(
      version_id=version_id,
  )
  ```
</CodeGroup>

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

**Returns:** `AnalysisVersionSchema`

## `list`

GET `/security/analyses`

<CodeGroup>
  ```python Async theme={null}
  result = await client.versions.list()
  ```

  ```python Sync theme={null}
  result = client.versions.list()
  ```
</CodeGroup>

| 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}`

<CodeGroup>
  ```python Async theme={null}
  result = await client.versions.delete(
      version_id=version_id,
  )
  ```

  ```python Sync theme={null}
  result = client.versions.delete(
      version_id=version_id,
  )
  ```
</CodeGroup>

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

**Returns:** `AnalysisSchema`

## `fork`

POST `/security/versions/{version_id}/fork`

<CodeGroup>
  ```python Async theme={null}
  result = await client.versions.fork(
      version_id=version_id,
  )
  ```

  ```python Sync theme={null}
  result = client.versions.fork(
      version_id=version_id,
  )
  ```
</CodeGroup>

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

**Returns:** `AnalysisSchema`

## `merge`

POST `/security/analyses/merge`

<CodeGroup>
  ```python Async theme={null}
  result = await client.versions.merge(
      from_version_id=from_version_id,
      to_version_id=to_version_id,
  )
  ```

  ```python Sync theme={null}
  result = client.versions.merge(
      from_version_id=from_version_id,
      to_version_id=to_version_id,
  )
  ```
</CodeGroup>

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

**Returns:** `AnalysisSchema`

## `commit`

POST `/security/versions/{version_id}/commit`

<CodeGroup>
  ```python Async theme={null}
  result = await client.versions.commit(
      version_id=version_id,
  )
  ```

  ```python Sync theme={null}
  result = client.versions.commit(
      version_id=version_id,
  )
  ```
</CodeGroup>

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

**Returns:** `AnalysisSchema`

## `set_head`

POST `/security/versions/{version_id}/head`

<CodeGroup>
  ```python Async theme={null}
  result = await client.versions.set_head(
      version_id=version_id,
  )
  ```

  ```python Sync theme={null}
  result = client.versions.set_head(
      version_id=version_id,
  )
  ```
</CodeGroup>

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

**Returns:** `AnalysisSchema`

## `entrypoints`

GET `/security/versions/{version_id}/entrypoints`

<CodeGroup>
  ```python Async theme={null}
  result = await client.versions.entrypoints(
      version_id=version_id,
  )
  ```

  ```python Sync theme={null}
  result = client.versions.entrypoints(
      version_id=version_id,
  )
  ```
</CodeGroup>

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

**Returns:** `ResultsResponse[EntryPointSchema]`

## `findings`

GET `/security/versions/{version_id}/findings`

<CodeGroup>
  ```python Async theme={null}
  result = await client.versions.findings(
      version_id=version_id,
  )
  ```

  ```python Sync theme={null}
  result = client.versions.findings(
      version_id=version_id,
  )
  ```
</CodeGroup>

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

**Returns:** `ResultsResponse[FindingSchema]`

## `diff_staged`

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

<CodeGroup>
  ```python Async theme={null}
  result = await client.versions.diff_staged(
      version_id=version_id,
  )
  ```

  ```python Sync theme={null}
  result = client.versions.diff_staged(
      version_id=version_id,
  )
  ```
</CodeGroup>

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

**Returns:** `ResultsResponse[FindingDiffItem]`

## `diff_version`

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

<CodeGroup>
  ```python Async theme={null}
  result = await client.versions.diff_version(
      version_id=version_id,
  )
  ```

  ```python Sync theme={null}
  result = client.versions.diff_version(
      version_id=version_id,
  )
  ```
</CodeGroup>

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

**Returns:** `ResultsResponse[FindingDiffItem]`

## `run`

POST `/security/versions/{version_id}/run`

<CodeGroup>
  ```python Async theme={null}
  result = await client.versions.run(
      version_id=version_id,
  )
  ```

  ```python Sync theme={null}
  result = client.versions.run(
      version_id=version_id,
  )
  ```
</CodeGroup>

| 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`

<CodeGroup>
  ```python Async theme={null}
  result = await client.versions.retry(
      version_id=version_id,
  )
  ```

  ```python Sync theme={null}
  result = client.versions.retry(
      version_id=version_id,
  )
  ```
</CodeGroup>

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

**Returns:** `AnalysisVersionSchema`