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.
Authorization
bearerAuth A personal access token from Settings > API tokens.
In: header
Path Parameters
Workspace slug (GET /me lists yours).
Agent slug within the workspace.
Query Parameters
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.
^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$Full-text search across transcript content.
length <= 200Also 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.
falseInclude silent calls, where the caller never spoke. Off by default.
Only calls that started at or after this ISO 8601 time.
^(?:(?:\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)))$date-timeOnly calls that started at or before this ISO 8601 time.
^(?:(?:\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)))$date-timeOnly calls whose analysed outcome is this one.
"completed" | "abandoned" | "transferred" | "failed"Items per page, 1 to 50. Default 50.
1 <= value <= 50The 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.