> This page is for version v2 (default).
> For other versions, use one of these documentation indexes:
> - v2 (default): https://docs.pinnacle.sh/v-2/llms.txt
> - v1: https://docs.pinnacle.sh/v1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.pinnacle.sh/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.pinnacle.sh/_mcp/server.

## Voice calls

Start, monitor, stream, and record voice calls through Pinnacle.

### What's new?

* New [`/calls`](/api-reference/calls/lifecycle/create-call) endpoints for outbound call creation, listing, lookup, metadata updates, cancellation, event history, WebSocket stream tokens, recording download, and recording deletion.
* New `CALL.STATUS` webhook event for phone-number subscribers. Use it to receive call lifecycle updates: `RINGING`, `ANSWERED`, `BRIDGED`, `ENDED`, `NO_ANSWER`, and `BUSY`.
* New [Voice Calls](/guides/voice-calls) guide covering REST setup, stream tokens, WebSocket command frames, live audio frames, recordings, and call status webhooks.
* New [Voice WebSockets](/methods/voice-websockets) method page with TypeScript, Python, and Ruby SDK helper examples for connecting, sending commands, and reconnecting.