Calls

Fire a call now

POST /v1/calls
{
  "to_number": "+37061234567",
  "agent_id": 3,
  "from_number": "+37052636333"
}

Response: `{"ok": true, "status": "queued_immediate"}` — fires within 60 s.

Schedule a call

POST /v1/calls
{
  "to_number": "+37061234567",
  "agent_id": 3,
  "schedule_at": "2026-09-05T09:00:00Z"
}

Response: `{"ok": true, "status": "scheduled", "scheduled_at": "2026-09-05 09:00:00"}`

- `schedule_at` is UTC ISO-8601. The call fires within 60 s of the scheduled time.

- Cancel with `DELETE /v1/schedules/{id}` while still `pending`.

- `from_number` must be one of your own assigned numbers.

Call lifecycle

1. `POST /v1/calls` → schedule created

2. Scheduler fires → Asterisk originate → SIP answers

3. Engine connects: STT → LLM → TTS, tools and knowledge active

4. On hang-up: transcript + summary + recording generated

5. Email sent (transcript + .mp3 attached), recording deleted from our servers

6. Billing: included minutes first, then wallet overage

List & inspect

- `GET /v1/calls` — history with billing detail

- `GET /v1/calls/{uuid}` — transcript, summary, recording status, COGS

- `GET /v1/schedules` — scheduled calls