channels

Toggle recording on a live call channel

Changed on

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

Request

  • Base URL
    https://public-api.ringover.com/v2
  • URL
    https://public-api.ringover.com/v2/channels/{channelId}/events/record/toggle
  • Auth
    API key in header Authorization

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.

Changes