# calls

> Call log, transcripts, recordings, transfers and call permissions.

Call log, transcripts, recordings, transfers and call permissions.

| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | `/v1/calls` | `calls_list`: Call log | `calls:read` | - |
| POST | `/v1/calls` | `calls_place`: Place an outbound call | `calls:write` | - |
| GET | `/v1/calls/{call_id}` | `calls_get`: Call detail | `calls:read` | - |
| POST | `/v1/calls/{call_id}/apply-crm` | `calls_apply_crm`: Write this call back to the CRM now | `calls:write` | - |
| GET | `/v1/calls/{call_id}/commands` | `calls_commands_list`: Steps a flow is waiting for this call to carry out | `calls:read` | - |
| POST | `/v1/calls/{call_id}/create-contact` | `calls_create_contact`: Create or merge a contact from the caller | `calls:write` | - |
| POST | `/v1/calls/{call_id}/hangup` | `calls_hangup`: End a call | `calls:write` | - |
| POST | `/v1/calls/{call_id}/outcome` | `calls_record_outcome`: Record the call outcome (disposition) | `calls:write` | - |
| DELETE | `/v1/calls/{call_id}/recording` | `calls_recording_delete`: Delete the recording | `calls:write` | - |
| GET | `/v1/calls/{call_id}/recording` | `calls_recording`: Signed recording URL (15 min) | `calls:read` | - |
| POST | `/v1/calls/{call_id}/summarize` | `calls_summarize`: Generate the call summary and action items | `ai:read` | - |
| GET | `/v1/calls/{call_id}/transcript` | `calls_transcript`: Transcript segments | `calls:read` | - |
| POST | `/v1/calls/{call_id}/transfer` | `calls_transfer`: Warm-transfer to a human | `calls:write` | - |
| GET | `/v1/calls/summary` | `calls_summary`: Call counts for a period | `calls:read` | - |
| POST | `/v1/contacts/{contact_id}/call-permission-request` | `calls_permission_request`: Ask the contact for WhatsApp call permission | `messages:send` | - |
| POST | `/v1/voice/call-commands/{command_id}/complete` | `calls_command_complete`: Report what the caller pressed or said | `calls:write` | - |
| GET | `/v1/voice/crm-rules` | `calls_crm_rules_get`: How finished calls write back to the CRM | `calls:read` | - |
| PUT | `/v1/voice/crm-rules` | `calls_crm_rules_put`: Set how finished calls write back to the CRM | `calls:write` | - |
| GET | `/v1/voice/messages` | `voice_messages_list`: Messages taken by the AI receptionist | `calls:read` | - |
| POST | `/wh/livekit/{provider}` | `livekit_webhook`: LiveKit server webhook (internal) | public | - |
| POST | `/wh/telephony/{provider}` | `telephony_webhook`: Telephony CPaaS call status callback (internal) | public | - |

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