Compare agent versions

Diff two versions of an agent, including its LLM or flow.

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

Compares two versions of an agent together with the LLM or flow each one resolves to. Returns both configurations, a list of field-level changes and a short readable summary. Beyond Retell

Request#

Path parameters#

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

Query parameters#

Parameter	Type	Required	Description
`base`	integer or string	No	Version reference to compare from. Default `latest_published`.
`target`	integer or string	No	Version reference to compare to. Default `latest`.

Example request#

curl "https://api.tried.com.au/compare-agent-versions/agent_3f9a1c0b2d4e5f6a7b8c9d0e?base=prod&target=latest" \
  -H "Authorization: Bearer $TRIED_API_KEY"

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

import os, requests

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

Response#

200 OK

{
  "base_version": 1,
  "target_version": 2,
  "base": { "agent": { "agent_id": "agent_3f9a1c0b2d4e5f6a7b8c9d0e", "voice_speed": 1 }, "llm": { "llm_id": "llm_9c8b7a6f5e4d3c2b1a0f9e8d" } },
  "target": { "agent": { "agent_id": "agent_3f9a1c0b2d4e5f6a7b8c9d0e", "voice_speed": 1.1 }, "llm": { "llm_id": "llm_9c8b7a6f5e4d3c2b1a0f9e8d" } },
  "changes": [{ "path": "agent.voice_speed", "kind": "changed", "before": 1, "after": 1.1 }],
  "summary": ["Voice speed: 1 to 1.1"]
}

Field	Type	Description
`base`, `target`	object	`agent` plus `llm` or `flow`, as resolved for each version (shortened above).
`changes`	array	`path` (dotted), `kind` (`added`, `removed` or `changed`), `before`, `after`. `version`, `is_published` and `last_modification_timestamp` are ignored.
`summary`	string[]	Readable lines, for example `Added function: book_appointment` or `Prompt edited (+120 characters)`.

Errors#

Status	When
`400`	A version reference is unknown or points at no published version.
`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 a version does not exist.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.