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

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

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

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

{
  "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"
    }
  ]
}