Calls
Calls

List calls

List this agent's calls, newest first, each with its sessionId, agent name, the caller's number and name, channel, sentiment/outcome, the analysis summary, topic and urgency, its length in seconds, and a coarse metric pass/fail summary. Call this FIRST to resolve a sessionId before get_call_bundle, get_call_metrics or evaluate_call. Narrow it with since, until and outcome; page through older calls by passing back next_cursor until it is null. Real calls only by default; pass includeTests=true to widen to test and discovery calls. Eval runs never appear here.

GET
/workspaces/{workspace}/agents/{agent}/calls

Authorization

bearerAuth
AuthorizationBearer <token>

A personal access token from Settings > API tokens.

In: header

Path Parameters

workspace*string

Workspace slug (GET /me lists yours).

agent*string

Agent slug within the workspace.

Query Parameters

agentId?string

Leave this out: list_calls lists the calls of the agent this call targets. If you pass it, it must be that agent's id.

Match^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
search?string

Full-text search across transcript content.

Lengthlength <= 200
includeTests?boolean

Also return in-app test calls and discovery-line calls, not just production ones. Eval runs are never returned, read those from the eval-run tools. Default false.

Defaultfalse
includeSilent?boolean

Include silent calls, where the caller never spoke. Off by default.

since?string

Only calls that started at or after this ISO 8601 time.

Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
Formatdate-time
until?string

Only calls that started at or before this ISO 8601 time.

Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
Formatdate-time
outcome?string

Only calls whose analysed outcome is this one.

Value in"completed" | "abandoned" | "transferred" | "failed"
limit?integer

Items per page, 1 to 50. Default 50.

Range1 <= value <= 50
cursor?string

The next_cursor of the previous page.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/workspaces/string/agents/string/calls"
{
  "data": [
    {
      "sessionId": "string",
      "property1": null,
      "property2": null
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ],
  "estimate": {},
  "retryAfterSeconds": 0
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ],
  "estimate": {},
  "retryAfterSeconds": 0
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ],
  "estimate": {},
  "retryAfterSeconds": 0
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ],
  "estimate": {},
  "retryAfterSeconds": 0
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ],
  "estimate": {},
  "retryAfterSeconds": 0
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ],
  "estimate": {},
  "retryAfterSeconds": 0
}
{
  "type": "http://example.com",
  "title": "string",
  "status": 0,
  "detail": "string",
  "code": "string",
  "errors": [
    {
      "path": "string",
      "message": "string"
    }
  ],
  "estimate": {},
  "retryAfterSeconds": 0
}

Get a call: transcript, metrics, tool calls and analysis GET

What happened on one call of this agent, in one read. By default returns the compact view: the session row (end reason, the carrier's call control and leg ids, hangup cause, carrier quality); the agent and the version the call ran on, as identity only (version id and number, model, voice, tool names); the full transcript with untruncated tool calls and results and interruption times; per-turn latency (every voice_turn_timing measurement that has a value); pipeline spans; tool call events; audio quality; the analysis summary; every metric result with its key, name, verdict and reasoning; turn-taking and carrier events; message deliveries, post-call actions and outcomes; signed links to the clean, ambient and carrier recordings (valid 24 hours; stereo, caller on the left channel, agent on the right), when the workspace's recording download setting admits your role (otherwise `recordings.linksWithheld` says so and each recording carries its path only); and, for platform staff only, links to the call's trace, logs and error reports, and the runtime's stream and machine ids. `unavailable` names any source that could not be read. The transcript, tool call events, function calls, detail captures and word timings arrive as JSON inside an untrusted-data block. Rows leave out their ids, the columns that repeat the call and the columns that are null. `omitted` names each part and column the compact view leaves out. Pass `section` to read one part without the rest of the call: `agentConfig` (the agent's settings, and the version's system prompt, settings and variables), `tools` (the version's tool definitions with descriptions, params and requires), `metricDefinitions` (the agent's active metric definitions), `metricDetail` (every metric result with its detail payload), `telnyxPayloads` (every carrier event with its raw payload) or `wordTimings` (the start and end of each word the caller spoke, keyed by message id and sequence). `section: "full"` returns the whole bundle in one reply, several times what a client shows inline.

Have the agent ring your phone POST

Call the operator's verified mobile and run the agent's CURRENT DRAFT over a real phone call, so they can hear unsaved/unpublished edits live (the assistant-invokable twin of the Call-me button; both dial the current draft). The dialed number is always the caller's own phone-verified AU mobile, there is no number input. Limited to 3 calls per hour per workspace. If the caller's mobile isn't verified, this returns an error telling them to verify it in Preferences → Profile. Use it to let the operator hear their latest changes on a real line; for a fast headless check of the draft without a phone, use talk_to_agent instead.