latestOpenAPI 3.1.1Proprietary – Contact us for usage terms2026-08-20173183551.4 KB

9da73dd2f99e

channels

Toggle recording on a live call channel

Toggles call recording on a live call channel. If the call is not being recorded, recording starts — the audio is captured and stored for later retrieval via GET /calls/{callId}/channels/{channelId}. If already recording, it stops. This is a real-time telephony control — the effect is immediate.

The channelId identifies a specific participant's leg in the call. Use POST /calls/current to discover active channel IDs. Recording availability also depends on the team's recording policy configuration.

Permission: Calls Write required.

Monitoring: Required. This is a live call supervisory control. Returns 401 Unauthorized if Monitoring is OFF on your API key.

post/channels/{channelId}/events/record/toggle

Path parameters

channelIdstring required

The unique identifier of the call channel. Use POST /calls/current to discover active channel IDs.

Response

Successfully processed — the recording toggle event has been applied to the channel.