Create agent tag

Add an environment tag to an agent.

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

Creates a tag. An agent can have at most 10 tags. Beyond Retell

Request#

Path parameters#

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

Body#

Field	Type	Required	Description
`name`	string	Yes	Lowercase letters, numbers, `-` and `_`, starting with a letter, up to 32 characters.
`version`	integer or null	No	Version to point at. Must exist. `null` or omitted means the latest published version.
`dynamic_variables`	object	No	String values applied to calls that use the tag. Default `{}`.

Example request#

curl -X POST "https://api.tried.com.au/agents/agent_3f9a1c0b2d4e5f6a7b8c9d0e/tags" \
  -H "Authorization: Bearer $TRIED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "canary",
  "version": 2,
  "dynamic_variables": {
    "environment": "canary"
  }
}'

const res = await fetch("https://api.tried.com.au/agents/agent_3f9a1c0b2d4e5f6a7b8c9d0e/tags", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TRIED_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "canary",
    "version": 2,
    "dynamic_variables": {
      "environment": "canary"
    }
  }),
});
const data = await res.json();

import os, requests

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

Response#

201 Created with the tag.

Errors#

Status	When
`400`	Validation failed, or the agent already has 10 tags.
`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 or version does not exist.
`409`	A tag with this name already exists.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.