List agent versions

{
  "status": "ok",
  "response": {
    "pagination": {
      "total_records": 3,
      "limit": 20,
      "offset": 0
    },
    "versions": [
      {
        "version_id": "e484b989-14e9-49a9-a019-78df8443620c",
        "version_number": 3,
        "created_at": "2024-01-15T09:30:00Z",
        "created_by": "jane@example.com",
        "is_active": true,
        "description": "Switch to a faster voice"
      },
      {
        "version_id": "bcb40d4c-4cc1-44b4-9d7b-5d9ab752f5c2",
        "version_number": 2,
        "created_at": "2024-01-15T09:30:00Z",
        "created_by": "jane@example.com",
        "is_active": false,
        "description": "Update greeting"
      },
      {
        "version_id": "4ad61e5e-2f79-496a-b234-889d010fabc7",
        "version_number": 1,
        "created_at": "2024-01-15T09:30:00Z",
        "created_by": "system",
        "is_active": false,
        "description": "Initial version"
      }
    ]
  }
}

Lists the published versions of an agent, newest first. The first page (offset 0) always includes the active version on top of limit, so it can return up to limit + 1 versions. Later pages skip the active version, so increase offset by limit to read the next page.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

model_idstringRequired

Agent ID. You can find it on the agent’s page in your dashboard.

Query parameters

limitintegerOptional1-100Defaults to 20

Versions returned per page, not counting the active version on the first page. Between 1 and 100.

offsetintegerOptional>=0Defaults to 0

Number of versions to skip, not counting the active version.

Response

200

statusstringOptional

Whether the request was successful.

responseobjectOptional

Errors

400

Bad Request Error

404

Not Found Error