***

title: record
slug: /reference/python/rest/calling/record
description: Start recording an active call via REST.
max-toc-depth: 3
---------------------

For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

[pause]: /docs/server-sdks/reference/python/rest/calling/record-pause

[resume]: /docs/server-sdks/reference/python/rest/calling/record-resume

[stop]: /docs/server-sdks/reference/python/rest/calling/record-stop

Start recording an active call. Returns a `control_id` used to
[pause][pause],
[resume][resume],
or [stop][stop] the recording.

<EndpointSchemaSnippet endpoint="POST /api/calling/calls" />

## **Response Example**

<EndpointResponseSnippet endpoint="POST /api/calling/calls" />

## **Example**

```python {9}
from signalwire.rest import RestClient

client = RestClient(
    project="your-project-id",
    token="your-api-token",
    host="your-space.signalwire.com",
)

result = client.calling.record(
    call_id="call-id-xxx",
    audio={"format": "mp3", "stereo": True}
)
control_id = result.get("control_id")
```