v77

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-08-012528701.8 MB

Calls

Stream status callback

Sent to your status_url when a background audio stream started with calling.stream changes state. params.state is streaming when the stream starts and finished when it ends.

postWebhookstreamStatusCallback

Payload

event_type'calling.call.stream' required

The type of event. Always calling.call.stream for stream status callbacks.

event_channelstring required

The channel the event was delivered on.

timestampnumber required

When the event was sent, as a Unix timestamp in seconds.

project_idstring uuid required

Your project ID.

space_idstring uuid required

Your Space ID.

Example payload

{
  "event_type": "calling.call.stream",
  "event_channel": "swml:451ed9ff-e568-4222-8af9-4f9ab7428d09",
  "timestamp": 1777565701.5623918,
  "project_id": "4d0d6f16-5881-4fcc-92a4-02c51a91954d",
  "space_id": "451ed9ff-e568-4222-8af9-4f9ab7428d09",
  "params": {
    "call_id": "2e1e66e5-5d07-413d-9668-55542992eec0",
    "node_id": "a0d4e6e5-5d07-413d-9668-55542992eec0",
    "segment_id": "2e1e66e5-5d07-413d-9668-55542992eec0",
    "tag": "my-tag",
    "control_id": "stream-control-1",
    "state": "streaming",
    "url": "wss://example.com/stream",
    "name": "customer-support-recording"
  }
}

Response

Webhook received