voice-calls.get
read-only
Fetch a single voice-AI-agent call by id, with its full action timeline (every MCP tool the agent invoked during the call, oldest-first). RLS blocks cross-tenant reads — unknown id returns an empty actions list and call:null.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
id | string | yes |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
call | object · nullable | yes | |
call.id | string | yes | |
call.callerNumber | string · nullable | yes | |
call.calledNumber | string | yes | |
call.startedAt | string | yes | |
call.endedAt | string · nullable | yes | |
call.durationSec | number · nullable | yes | |
call.outcome | enum · nullable | yes | One of: hold_created, info_only, transferred, dropped, failed |
call.summary | string · nullable | yes | |
call.transcript | array of object · nullable | yes | |
call.recordingUrl | string · nullable | yes | |
actions | array of object | yes | |
actions.id | string | yes | |
actions.toolName | string | yes | |
actions.input | any | yes | Tool-call arguments as the voice agent sent them — shape varies per toolName. |
actions.output | any | yes | Tool-call result as returned — shape varies per toolName. |
actions.error | string · nullable | yes | |
actions.at | string | yes |
voice-calls.list
read-only
List voice-AI-agent calls for this tenant, newest-first. Default window: last 30 days. Optionally filter by outcome (hold_created/info_only/transferred/dropped/failed). Used by external agents + operator MCP clients to inspect recent voice activity.
Input parameters
| Field | Type | Required | Notes |
|---|---|---|---|
days | literal | no | Default: 30 |
outcome | enum | no | One of: hold_created, info_only, transferred, dropped, failed |
limit | integer | no | Default: 50 |
Output fields
| Field | Type | Required | Notes |
|---|---|---|---|
items | array of object | yes | |
items.id | string | yes | |
items.callerNumber | string · nullable | yes | |
items.calledNumber | string | yes | |
items.startedAt | string | yes | |
items.endedAt | string · nullable | yes | |
items.durationSec | number · nullable | yes | |
items.outcome | enum · nullable | yes | One of: hold_created, info_only, transferred, dropped, failed |
items.summary | string · nullable | yes |