List versions of a conversational agent

GET /conversational_agents/{id}/versions

List versions of a conversational agent

cURL

curl --request GET \
  --url https://api.operator.xyz/conversational_agents/{id}/versions \
  --header 'Authorization: Bearer <token>' \
  --header 'Operator-Version: <operator-version>'

import requests

url = "https://api.operator.xyz/conversational_agents/{id}/versions"

headers = {
    "Operator-Version": "<operator-version>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'Operator-Version': '<operator-version>', Authorization: 'Bearer <token>'}
};

fetch('https://api.operator.xyz/conversational_agents/{id}/versions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

200

{
  "data": [
    {
      "version_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "name": "<string>",
      "description": "<string>"
    }
  ]
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

Authorizations

Authorization · string · header · required

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

Headers

Operator-Version · enum<string> · required

The API version to use.

Available options: 2025-06-19

Path Parameters

id · string · required

Unique identifier for the agent, e.g. ca_8qm9JBCiTe7

Response

200

application/json

Successful response.

data · get.conversational.agent.version · object[] · required

List of versions for this agent.

Show child attributes