Errors

HTTP status codes

Status	Meaning	Typical cause
200	Success	Request completed successfully.
201	Created	Resource created (example: tenant or intent).
400	Bad Request	Validation error or business rule failure.
401	Unauthorized	Missing/invalid/expired auth token.
403	Forbidden	Authenticated but not linked to tenant.
404	Not Found	Resource does not exist in tenant scope.
500	Internal Server Error	Unexpected processing or escalation failure.

{ "error": "Missing or invalid authorization header" }

{ "error": "Conversation not found" }

{ "success": false, "error": "Failed to create support ticket" }

WebSocket protocol errors are sent as message type error:

{
  "type": "error",
  "payload": {
    "message": "Invalid message format"
  }
}