List workflow runs

See the latest pre-call and post-call workflow runs of an agent, with each step's result.

GEThttps://api.tried.com.au/agents/{agent_id}/workflow-runs

Returns the agent's most recent workflow runs, newest first, up to 50. This is the Recent runs list in the workflow editor. A run is stored each time an enabled stage with at least one step runs for a call. Test runs from Test agent workflow are not stored. See Workflows.

Request#

Path parameters#

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

Query parameters#

Parameter	Type	Required	Description
`call_id`	string	No	Only runs linked to this call.

Example request#

curl "https://api.tried.com.au/agents/agent_3f9a1c0b2d4e5f6a7b8c9d0e/workflow-runs?call_id=call_c837e1e2d9691e32ae3bbd47" \
  -H "Authorization: Bearer $TRIED_API_KEY"

const url = new URL("https://api.tried.com.au/agents/agent_3f9a1c0b2d4e5f6a7b8c9d0e/workflow-runs");
url.searchParams.set("call_id", "call_c837e1e2d9691e32ae3bbd47");
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const runs = await res.json();

import os, requests

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

Response#

200 OK with an array of runs.

[
  {
    "workflow_run_id": "wf_run_5c2e8a1f3b7d9e0a4c6f2b18",
    "agent_id": "agent_3f9a1c0b2d4e5f6a7b8c9d0e",
    "stage": "pre_call",
    "call_id": "call_c837e1e2d9691e32ae3bbd47",
    "status": "success",
    "steps": [
      {
        "id": "lookup",
        "name": "CRM lookup",
        "status": "success",
        "duration_ms": 184,
        "outputs": { "customer_name": "Sam Nguyen", "tier": "gold" },
        "http_status": 200
      }
    ],
    "outputs": { "customer_name": "Sam Nguyen", "tier": "gold" },
    "duration_ms": 186,
    "created_timestamp": 1792310400000
  }
]

Field	Type	Description
`workflow_run_id`	string	Starts with `wf_run_`.
`stage`	string	`pre_call` or `post_call`.
`call_id`	string or null	The call the run belongs to. A pre-call run runs before the call exists and is linked once the call is created; it stays `null` if no call was created.
`status`	string	`success`, `partial`, `timeout` or `failed`.
`steps`	array	Step results, as in Test agent workflow.
`outputs`	object	All outputs merged.
`duration_ms`	integer	Total run time.
`created_timestamp`	integer	Unix ms when the run finished.

An agent with no runs, or an agent_id that is not in your workspace, returns an empty array.

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.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.