> ## Documentation Index
> Fetch the complete documentation index at: https://docs.persistence.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Calls API

> Start outbound call batches and end active calls.

Use the Calls API to start a batch of outbound calls and to end an active call by its session ID.

Every request requires a workspace API key in the `X-API-Key` header. The API key determines the workspace, so these paths do not include a workspace ID.

<CardGroup cols={1}>
  <Card title="Start outbound batch" icon="phone-outgoing" href="/api-reference/calls/start-batch">
    `POST /v1/calls/batch` — accept up to 1,000 recipients for immediate or scheduled calling.
  </Card>

  <Card title="End active call" icon="phone-off" href="/api-reference/calls/end-call">
    `POST /v1/calls/{roomId}/end` — end the active session identified by `roomId`.
  </Card>
</CardGroup>

Recipient `metadata` carries string values into the call. Check `acceptedRecipients` and `rejectedRecipients` in the batch response before treating a submission as fully accepted.