Docs
OverviewGuidesZero & MCPAPI referenceChangelog
Voice

Book Meeting

Book a slot offered on this call; adds ``meeting_booked`` to the lead timeline.

API key access

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

Authorization

AuthorizationBearer <token>

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

In: header

Path Parameters

call_idstring
Formatuuid

Header Parameters

X-Workspace-Id?string | null

Workspace of the call (must match the token).

Request Body

lead_idstring
Formatuuid
slot_idstring
Length1 <= length <= 64
startstring
Formatdate-time
endstring
Formatdate-time
attendee_email?string | null
Lengthlength <= 320
notes?string
Default""
Lengthlength <= 2000

Response Body

curl -X POST "http://localhost:8000/api/v1/calls/497f6eca-6276-4993-bfeb-53cbbbba6f08/meetings" \  -H "X-Workspace-Id: string" \  -H "Content-Type: application/json" \  -d '{    "lead_id": "9bddab70-98e6-43a9-8f32-c9788b9de0c0",    "slot_id": "string",    "start": "2019-08-24T14:15:22Z",    "end": "2019-08-24T14:15:22Z"  }'
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "start": "2019-08-24T14:15:22Z",
  "label": "string"
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Availability

Up to 3 open slots. Only slots returned here can be booked on this call. No calendar until RO-046: slots fall in the workspace's business hours (``/workspaces/current/business-hours``, provider ``business_hours``), else Mon-Fri defaults (provider ``business_hours_stub``).

Complete

Final outcome, summary and answers; adds ``call_completed`` to the timeline. Idempotent. The first completion also stores the transcript and queues the post-call AI analysis (summary + extracted fields, shown on ``GET /calls/{call_id}``).