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

# List Agent Versions — GET /api/v1/bot/agent-versions

> Retrieve all saved versions for a Botsify agent, including version IDs, names, configuration fields, and which version is currently active.

Use this endpoint to fetch every saved version associated with a specific Botsify agent. The response includes each version's ID, name, and the configuration fields stored at the time it was saved — making it easy to audit history, compare snapshots, or choose a version to activate.

## Request

**`GET https://app.botsify.com/api/v1/bot/agent-versions`**

**Authorization:** Bearer token — include your token in the `Authorization: Bearer <token>` header.

### Query Parameters

**bot\_id** `integer`

The unique identifier of the bot whose versions you want to list. When omitted, the API returns versions for the bot associated with the authenticated token.

## Example

```bash theme={null}
curl --request GET \
  --url "https://app.botsify.com/api/v1/bot/agent-versions?bot_id=42" \
  --header "Authorization: Bearer <your_token>"
```

## Response

A successful request returns `200 OK` with a JSON array. Each element represents one saved version and contains the following fields:

| Field | Type | Description |
| - | - | - |
| `id` | integer | Unique version ID |
| `name` | string | Human-readable version name |
| `agent` | string | Main agent instruction text |
| `chat_flow` | string | Conversation flow definition |
| `memory` | string \| null | Agent memory configuration |
| `soul` | string \| null | Agent personality settings |
| `identity` | string \| null | Identity configuration |
| `user_info` | string \| null | User context handling rules |
| `is_active` | boolean | Whether this is the currently active version |
| `created_at` | string | ISO 8601 timestamp of creation |

```json theme={null}
{
  "versions": [
    {
      "id": 7,
      "name": "v1.0 — Launch",
      "agent": "You are a helpful support assistant...",
      "chat_flow": "...",
      "memory": null,
      "soul": null,
      "identity": null,
      "user_info": null,
      "is_active": false,
      "created_at": "2024-03-01T10:00:00Z"
    },
    {
      "id": 12,
      "name": "v2.0 — Tone Update",
      "agent": "You are a friendly support assistant...",
      "chat_flow": "...",
      "memory": "Remember the user's last order.",
      "soul": "Empathetic and concise.",
      "identity": null,
      "user_info": null,
      "is_active": true,
      "created_at": "2024-04-15T14:22:00Z"
    }
  ]
}
```


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