Docs
OverviewGuidesZero & MCPAPI referenceChangelog
Voice

Save Answer

Save one qualification answer. 422 for a field this call doesn't collect.

API key access

This route has its own authentication (or none); an API key is not used here.
PUT/api/v1/calls/{call_id}/answers/{field}

Authorization

AuthorizationBearer <token>

Per-call token issued when the call was created (job metadata api_token).

In: header

Path Parameters

fieldstring
call_idstring
Formatuuid

Header Parameters

X-Workspace-Id?string | null

Workspace of the call (must match the token).

Request Body

lead_idstring
Formatuuid
valuestring
Length1 <= length <= 4000

Response Body

curl -X PUT "http://localhost:8000/api/v1/calls/497f6eca-6276-4993-bfeb-53cbbbba6f08/answers/string" \  -H "X-Workspace-Id: string" \  -H "Content-Type: application/json" \  -d '{    "lead_id": "9bddab70-98e6-43a9-8f32-c9788b9de0c0",    "value": "string"  }'
Empty
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Run Audition

Synthesise `text` (at most 200 characters) with 1-5 voices. Each sample comes back in full quality and in phone quality (8 kHz mu-law, what a caller hears) with the provider's time to first byte. Per-sample failures (no key, a cap reached, the provider refused) are reported in the sample, never retried. Caps: 30 new samples per workspace and UTC day (cached replays are free) and a daily character budget per provider on the platform's keys. Owners and admins.

Schedule Callback

Flag the call for a callback. The free-text `preferred_time` is read in the lead's time zone and, when telephony is configured, an AI callback call is queued for then (compliance re-checked when it runs); otherwise the lead gets a task note for a human (RO-134).