record

View as MarkdownOpen in Claude

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

Request

idstringRequiredformat: "uuid"
The unique identifying ID of a existing call.
paramsobjectRequired
An object of parameters that will be utilized by the active command.

Response

Call LegobjectRequired
Returned when the call is a standard PSTN, SIP, or WebRTC call.
OR
Fabric Subscriber Device LegobjectRequired

Example

1import { RestClient } from "@signalwire/sdk";
2
3const client = new RestClient({
4 project: "your-project-id",
5 token: "your-api-token",
6 host: "your-space.signalwire.com"
7});
8
9const result = await client.calling.record("call-id-xxx", {
10 audio: { format: "mp3", stereo: true }
11});
12const controlId = result.control_id;