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

# Agent versions APIs overview

> Explore Bolna Agent versions APIs to save voice agent configurations as versions, test them with agent_version_id, make one live and roll back.

An agent version is a saved copy of an agent's full configuration. One version is **live** and every call uses it, unless the call passes another version's `id` as `agent_version_id` to [`POST /call`](https://www.bolna.ai/docs/api-reference/calls/make#call-a-specific-agent-version). Versions apply to regular agents; graph agents have their own [version history](https://www.bolna.ai/docs/graph-agent/version-history.md). To compare versions on real calls, see [A/B test agent versions](https://www.bolna.ai/docs/agents/ab-testing.md).

## Endpoints

```
GET /v2/agent/:agent_id/versions
GET /v2/agent/:agent_id/versions/:agent_version_id
POST /v2/agent/:agent_id/versions
PUT /v2/agent/:agent_id/versions/:agent_version_id
PATCH /v2/agent/:agent_id/versions/:agent_version_id
POST /v2/agent/:agent_id/versions/:agent_version_id/set_current
DELETE /v2/agent/:agent_id/versions/:agent_version_id
```

## Agent version object attributes

* `id`  *string*\

  Unique identifier of the version. Pass it as `agent_version_id` to the version endpoints and to [`POST /call`](https://www.bolna.ai/docs/api-reference/calls/make#call-a-specific-agent-version)

* `version_name`  *string*\

  Name of the version, unique within the agent. New versions are named `v1`, `v2` and so on until you [rename](https://www.bolna.ai/docs/api-reference/agent/v2/versions/patch.md) them

* `tags`  *array*\

  Tags for the version

* `version_status`  *string*\

  `saved` for the save created with [Save as new version](https://www.bolna.ai/docs/api-reference/agent/v2/versions/create.md), `published` for later saves into the version or saves of the live version

* `is_current`  *boolean*\

  `true` for the live version

* `created_at`  *string*\

  When this save was made

* `updated_at`  *string*\

  When this save was last updated

> [!NOTE]
>
> Every save into a version shares its `version_name`, and each save gets a new `id`. [Saving edits into a version](https://www.bolna.ai/docs/api-reference/agent/v2/versions/update.md) returns the new `id`; use it for the next request. Renaming or deleting a version applies to all of its saves, and the live version can't be deleted.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.