POST/realtime/calls/{call_id}/hangup

Hang up call

End an active Realtime API call, whether it was initiated over SIP or WebRTC.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter
call_idstringrequired
The identifier for the call. For SIP calls, use the value provided in the [`realtime.call.incoming`](https://developers.openai.com/api/reference/resources/webhooks#realtime.call.incoming) webhook. For WebRTC sessions, reuse the call ID returned in the `Location` header when creating the call with [`POST /v1/realtime/calls`](https://developers.openai.com/api/reference/resources/realtime/subresources/calls/methods/create).

2 status codes
200Call hangup initiated successfully.
404The session or call was not found or is unavailable for this operation.
errorobjectrequired

Error handling

A 404 is returned: The session or call was not found or is unavailable for this operation.