Update agent tag

Move a tag to another version or replace its variables.

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

Points a tag at a different published version (to promote or roll back) and/or replaces its dynamic variables. Beyond Retell

Request#

Path parameters#

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

Body#

Field	Type	Required	Description
`version`	integer or null	No	A published version, or `null` for the latest published version.
`dynamic_variables`	object	No	Replaces the tag's variables. Values must be strings.

Example request#

curl -X PATCH "https://api.tried.com.au/agents/agent_3f9a1c0b2d4e5f6a7b8c9d0e/tags/prod" \
  -H "Authorization: Bearer $TRIED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "version": 3
}'

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

import os, requests

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

Response#

200 OK with the updated tag.

Errors#

Status	When
`400`	Validation failed, or the version is not published (`Tags can only point at published versions`).
`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, tag or version does not exist.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.