List an agent's versions
curl --request GET \
--url https://voice-api.onclarity.com/v1/projects/{projectId}/agents/{id}/versions \
--header 'Authorization: Bearer <token>'import requests
url = "https://voice-api.onclarity.com/v1/projects/{projectId}/agents/{id}/versions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://voice-api.onclarity.com/v1/projects/{projectId}/agents/{id}/versions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"versions": [
{
"id": "0d4e5f60-1a2b-4c3d-9e8f-7a6b5c4d3e21",
"agent_id": "3f0c6a52-8d7e-4b8a-9a43-0f2b5c1e9d11",
"version_number": 4,
"status": "draft",
"created_at": 1760090000000,
"created_by": "org-token:42",
"created_by_name": null,
"updated_at": 1760090000000,
"updated_by": "org-token:42",
"updated_by_name": null,
"first_published_at": null,
"published_at": null,
"published_by": null,
"published_by_name": null,
"channel": "org_api"
},
{
"id": "9a8b7c6d-1234-4f56-8a90-abcdef012345",
"agent_id": "3f0c6a52-8d7e-4b8a-9a43-0f2b5c1e9d11",
"version_number": 3,
"status": "published",
"created_at": 1760000000000,
"created_by": "org-token:42",
"created_by_name": null,
"updated_at": 1760000000000,
"updated_by": null,
"updated_by_name": null,
"first_published_at": 1760000000000,
"published_at": 1760000000000,
"published_by": "org-token:42",
"published_by_name": null,
"channel": "org_api"
}
]
}{
"error": "Invalid or revoked token"
}{
"error": "<string>",
"code": "<string>"
}{
"error": "<string>",
"code": "<string>"
}Agents
List an agent's versions
Returns every version of the agent, newest first: at most one draft, at most one published (the live one), and any number of outdated versions. Each entry is a summary; read a version by id for its full configuration.
GET
/
v1
/
projects
/
{projectId}
/
agents
/
{id}
/
versions
List an agent's versions
curl --request GET \
--url https://voice-api.onclarity.com/v1/projects/{projectId}/agents/{id}/versions \
--header 'Authorization: Bearer <token>'import requests
url = "https://voice-api.onclarity.com/v1/projects/{projectId}/agents/{id}/versions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://voice-api.onclarity.com/v1/projects/{projectId}/agents/{id}/versions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"versions": [
{
"id": "0d4e5f60-1a2b-4c3d-9e8f-7a6b5c4d3e21",
"agent_id": "3f0c6a52-8d7e-4b8a-9a43-0f2b5c1e9d11",
"version_number": 4,
"status": "draft",
"created_at": 1760090000000,
"created_by": "org-token:42",
"created_by_name": null,
"updated_at": 1760090000000,
"updated_by": "org-token:42",
"updated_by_name": null,
"first_published_at": null,
"published_at": null,
"published_by": null,
"published_by_name": null,
"channel": "org_api"
},
{
"id": "9a8b7c6d-1234-4f56-8a90-abcdef012345",
"agent_id": "3f0c6a52-8d7e-4b8a-9a43-0f2b5c1e9d11",
"version_number": 3,
"status": "published",
"created_at": 1760000000000,
"created_by": "org-token:42",
"created_by_name": null,
"updated_at": 1760000000000,
"updated_by": null,
"updated_by_name": null,
"first_published_at": 1760000000000,
"published_at": 1760000000000,
"published_by": "org-token:42",
"published_by_name": null,
"channel": "org_api"
}
]
}{
"error": "Invalid or revoked token"
}{
"error": "<string>",
"code": "<string>"
}{
"error": "<string>",
"code": "<string>"
}Authorizations
Your organization API key (it starts with anek_org_). The same key works on the Voice API and the Support API. See Authentication.
Response
The agent's versions.
Show child attributes
Show child attributes