# voice

> Call answering: voices, previews and draft settings.

Call answering: voices, previews and draft settings.

| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | `/v1/ai-assistants/{assistant_id}/calls` | `ai_assistant_calls_get`: Whether the AI Assistant answers calls, line by line | `calls:read` | - |
| PUT | `/v1/ai-assistants/{assistant_id}/calls` | `ai_assistant_calls_set`: Turn the AI Assistant on or off for calls | `calls:write` | - |
| POST | `/v1/voice/agents/{assistant_id}/test-call` | `voice_agent_test_call`: Create a test room, dispatch the voice agent and return a join token | `calls:write` | - |
| GET | `/v1/voice/agents/{assistant_id}/test-call/phone` | `voice_agent_phone_test_call_preview`: Which number a ring-my-phone test call would ring, and whether it can ring now | `calls:write` | - |
| POST | `/v1/voice/agents/{assistant_id}/test-call/phone` | `voice_agent_phone_test_call`: Ring my phone: an outbound test call from the assistant to your own verified mobile | `calls:write` | - |
| GET | `/v1/voice/analytics` | `voice_analytics`: Calls, answer rate, duration, outcomes, minutes used | `analytics:read` | - |
| GET | `/v1/voice/call-balance` | `voice_call_balance`: Call Balance | `billing:read` | - |
| POST | `/v1/voice/livekit/token` | `voice_livekit_token`: Mint a LiveKit access token (<= 10 min) | `calls:write` | - |
| GET | `/v1/voice/numbers` | `voice_numbers_list`: Phone lines | `calls:read` | - |
| POST | `/v1/voice/numbers` | `voice_numbers_provision`: Provision or port a number | `calls:write` | - |
| DELETE | `/v1/voice/numbers/{number_id}` | `voice_numbers_release`: Release a number | `calls:write` | - |
| GET | `/v1/voice/numbers/{number_id}` | `voice_numbers_get`: Get one phone line | `calls:read` | - |
| PATCH | `/v1/voice/numbers/{number_id}` | `voice_numbers_update`: Configure a number | `calls:write` | - |
| DELETE | `/v1/voice/numbers/{number_id}/draft` | `voice_numbers_draft_discard`: Discard the draft call-answering settings | `calls:write` | - |
| PUT | `/v1/voice/numbers/{number_id}/draft` | `voice_numbers_draft_put`: Save call-answering changes without making them live | `calls:write` | - |
| POST | `/v1/voice/numbers/{number_id}/draft/publish` | `voice_numbers_draft_publish`: Make the draft call-answering settings live | `calls:write` | - |
| GET | `/v1/voice/numbers/available` | `voice_numbers_available`: Search number inventory | `calls:read` | - |
| GET | `/v1/voice/packs` | `voice_packs_list`: Minute packs (100 / 500 / 2,000 minutes; never expire) | `billing:read` | - |
| GET | `/v1/voice/rooms` | `voice_rooms_list`: Live rooms for this org | `calls:read` | - |
| GET | `/v1/voice/rooms/{room_id}` | `voice_rooms_get`: One room | `calls:read` | - |
| POST | `/v1/voice/rooms/{room_id}/end` | `voice_rooms_end`: Force-end a room (also ends billing) | `calls:write` | - |
| GET | `/v1/voice/sip/trunks` | `voice_sip_trunks_list`: SIP trunks and dispatch rules for this org (read-only mirror) | `calls:read` | - |
| POST | `/v1/voice/sip/trunks` | `voice_sip_trunks_create`: Create a trunk and dispatch rule for a number | `calls:write` | - |
| DELETE | `/v1/voice/sip/trunks/{trunk_id}` | `voice_sip_trunks_delete`: Remove a trunk | `calls:write` | - |
| GET | `/v1/voice/sip/trunks/{trunk_id}` | `voice_sip_trunks_get`: One SIP trunk (read-only mirror) | `calls:read` | - |
| GET | `/v1/voice/voices` | `voice_voices_list`: Voices a phone line can speak with | `calls:read` | - |
| POST | `/v1/voice/voices/{voice_id}/preview` | `voice_voices_preview`: Hear a voice say a line | `calls:read` | - |

Request and response schemas: the interactive reference at `https://api.wapitick.com/docs`, or `docs/api/openapi.json`.
