Errors Reference

Control errors use this shape:

{
  "type": "response",
  "id": "request-id",
  "ok": false,
  "error": {
    "code": "BAD_REQUEST",
    "message": "sessionId is required"
  }
}

Common Codes

Code	Meaning
BAD_MESSAGE	WebSocket message envelope was invalid.
BAD_REQUEST	Command or HTTP body failed validation.
NOT_FOUND	Call, session, endpoint, route, or recording was not found.
CONFLICT	The requested state transition is invalid.
SERVICE_UNAVAILABLE	Required backend such as rtpbridge is not configured or unavailable.
SHUTTING_DOWN	Gateway is draining and cannot admit new work. HTTP command responses use 503 with Retry-After: 1.
INTERNAL_ERROR	Unexpected server error.

HTTP routes return JSON error bodies for command failures:

{ "error": "sessionId is required" }

Streaming recording routes may return backend status codes when proxied rtpbridge requests fail.