call.supervision.ended

Summary

call.supervision.ended fires once when a supervision is over. A supervisor who answered always ends with this event. A supervisor who never answered also ends here, with reason: "no_answer" and duration_seconds: 0. The call itself carries on unless it was the call that ended.

This event is subscribable as a workspace webhook: add call.supervision.ended to the events of a subscription created with Create a webhook. Supervision events are subscribed by name; there is no call.supervision.* wildcard. Delivery is at least once, so deduplicate on the X-Sautikit-Event-Id header.

Payload

The body is flat. The event kind travels in the X-Sautikit-Event-Kind header.

{
  "workspace_id": "01900000-0000-7000-8000-000000000002",
  "call_id": "9d2b1f53-8c0e-4f1d-9a6b-5d3a8c47e9f0",
  "session_id": "HD_24d73b4518bc",
  "supervision_id": "0f6d3c1e-5a8b-4c2d-9e7f-1a2b3c4d5e6f",
  "mode": "listen",
  "supervisor": {
    "type": "client",
    "identity": "mary",
    "label": "Mary Wanjiku"
  },
  "occurred_at": "2026-09-30T09:15:04Z",
  "reason": "supervisor_left",
  "duration_seconds": 95
}

Every supervision event carries workspace_id, call_id (the supervised call's UUID), session_id (its HD_ session id), supervision_id, mode, supervisor (type, then identity for client and sip or number for phone, and label when you set one) and occurred_at.

Fields

reason is one of:

• supervisor_left: the supervision was stopped through the API.
• supervisor_hangup: the supervisor hung up.
• call_ended: the customer or the agent hung up, so the call ended.
• call_transferred: the call was transferred or redirected. The supervisor does not follow it.
• no_answer: the supervisor did not answer within 30 seconds.
• insufficient_balance: the wallet could not cover the running supervisor leg, so Sautikit removed the supervisor.

Headers

Next steps

• Supervise live calls: start, switch and stop supervision.
• Webhook concepts: delivery, retries and subscriptions.