List agent tags

List an agent's environment tags.

GEThttps://api.tried.com.au/agents/{agent_id}/tags

Environment tags are named pointers to agent versions, such as prod and staging. Calls, phone number bindings and other version references can name a tag instead of a number, and each tag can carry its own dynamic variables. The first time an agent's tags are read or used, prod (pointing at the latest published version) and staging (pointing at nothing) are created. Beyond Retell

Request#

Path parameters#

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

Example request#

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

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

import os, requests

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

Response#

200 OK

[
  { "tag_id": "tag_4e5f6a7b8c9d0e1f2a3b4c5d", "agent_id": "agent_3f9a1c0b2d4e5f6a7b8c9d0e", "name": "prod", "version": 1, "dynamic_variables": {}, "last_modification_timestamp": 1792310400000 },
  { "tag_id": "tag_5f6a7b8c9d0e1f2a3b4c5d6e", "agent_id": "agent_3f9a1c0b2d4e5f6a7b8c9d0e", "name": "staging", "version": null, "dynamic_variables": {}, "last_modification_timestamp": 1792310400000 }
]

Field	Type	Description
`name`	string	Tag name.
`version`	integer or null	Version the tag points at. `null` means the latest published version.
`dynamic_variables`	object	Variables applied to calls that use this tag. Request variables override them.

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.