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.

Status callbacks are advisory, best-effort notifications — delivery can be delayed or fail silently, so don’t gate time-critical actions on receiving one. See Status callback reliability.

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. Status callbacks are advisory, best-effort notifications — delivery can be delayed or fail silently, so don't gate time-critical actions on receiving one. See [Status callback reliability](/docs/platform/webhooks#status-callback-reliability).

Payload

The payload of this webhook request is an object.

event_typeenumRequired

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

event_channelstringRequired

The channel the event was delivered on.

timestampdoubleRequired

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

project_idstringRequiredformat: "uuid"

Your project ID.

space_idstringRequiredformat: "uuid"

Your Space ID.

paramsobjectRequired

Details about the stream.

Response

200

Webhook received

1	{
2	"event_type": "calling.call.stream",
3	"event_channel": "swml:451ed9ff-e568-4222-8af9-4f9ab7428d09",
4	"timestamp": 1777565701.5623918,
5	"project_id": "4d0d6f16-5881-4fcc-92a4-02c51a91954d",
6	"space_id": "451ed9ff-e568-4222-8af9-4f9ab7428d09",
7	"params": {
8	"call_id": "2e1e66e5-5d07-413d-9668-55542992eec0",
9	"node_id": "a0d4e6e5-5d07-413d-9668-55542992eec0",
10	"segment_id": "2e1e66e5-5d07-413d-9668-55542992eec0",
11	"control_id": "stream-control-1",
12	"state": "streaming",
13	"url": "wss://example.com/stream"
14	}
15	}