Skip to content
TriedDocs
Voice agents

List agent workflows

Get an agent's pre-call and post-call workflows.

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

Returns both workflow stages of an agent, pre_call first and post_call second. A stage that was never saved is still returned, with enabled: false, the default budget and no steps. See Workflows for how steps run.

Request#

Path parameters#

Parameter Type Required Description
agent_id string Yes The agent.

Example request#

curl "https://api.tried.com.au/agents/agent_3f9a1c0b2d4e5f6a7b8c9d0e/workflows" \
  -H "Authorization: Bearer $TRIED_API_KEY"
const res = await fetch("https://api.tried.com.au/agents/agent_3f9a1c0b2d4e5f6a7b8c9d0e/workflows", {
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const workflows = await res.json();
import os, requests

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

Response#

200 OK with an array of two workflow objects.

[
  {
    "agent_id": "agent_3f9a1c0b2d4e5f6a7b8c9d0e",
    "stage": "pre_call",
    "enabled": true,
    "budget_ms": 3000,
    "steps": [
      {
        "id": "lookup",
        "name": "CRM lookup",
        "type": "http",
        "url": "https://crm.example.com/customers?phone={{to_number}}",
        "method": "GET",
        "headers": {},
        "values": {},
        "arguments": {},
        "depends_on": [],
        "outputs": { "customer_name": "data.name", "tier": "data.tier" },
        "timeout_ms": 2000
      }
    ],
    "last_modification_timestamp": 1792310400000
  },
  {
    "agent_id": "agent_3f9a1c0b2d4e5f6a7b8c9d0e",
    "stage": "post_call",
    "enabled": false,
    "budget_ms": 3000,
    "steps": [],
    "last_modification_timestamp": null
  }
]

Workflow object#

Field Type Description
agent_id string The agent.
stage string pre_call or post_call.
enabled boolean Whether the stage runs. false for a stage that was never saved.
budget_ms integer Time budget for the whole stage. Default 3000. Capped at run time, see Time budget.
steps array The steps as saved. See Update agent workflow.
last_modification_timestamp integer or null Unix ms of the last save. null for a stage that was never saved.

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 Agent <agent_id> not found.
429 Rate limit exceeded. See Rate limits.

See Errors for the body format.