List agent versions with tags

List every version of an agent with the environment tags that point at it.

GEThttps://api.tried.com.au/agent-versions/{agent_id}

Returns all versions, oldest first, each with a tags array of the environment tags that point at it. The first call for an agent creates its default prod and staging tags. Beyond Retell

Request#

Path parameters#

Parameter	Type	Required	Description
`agent_id`	string	Yes	The agent.

Example request#

curl "https://api.tried.com.au/agent-versions/agent_3f9a1c0b2d4e5f6a7b8c9d0e" \
  -H "Authorization: Bearer $TRIED_API_KEY"

const res = await fetch("https://api.tried.com.au/agent-versions/agent_3f9a1c0b2d4e5f6a7b8c9d0e", {
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.tried.com.au/agent-versions/agent_3f9a1c0b2d4e5f6a7b8c9d0e",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
data = res.json()

Response#

200 OK

[
  { "agent_id": "agent_3f9a1c0b2d4e5f6a7b8c9d0e", "version": 0, "is_published": true, "agent_name": "Bright Dental receptionist", "tags": [] },
  { "agent_id": "agent_3f9a1c0b2d4e5f6a7b8c9d0e", "version": 1, "is_published": true, "agent_name": "Bright Dental receptionist", "tags": ["prod"] },
  { "agent_id": "agent_3f9a1c0b2d4e5f6a7b8c9d0e", "version": 2, "is_published": false, "agent_name": "Bright Dental receptionist", "tags": [] }
]

Each item is a full agent plus tags (shortened above).

Errors#

Status	When
`401`	Missing or invalid API key.
`403`	The key's IP allowlist or scopes reject the request. This route needs the `agents` scope.
`404`	The agent does not exist.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.