Error Codes

Complete reference of error codes across 9 categories returned by the Chat Service.

Error response formatjson

{
  "error": {
    "code": "CHAT_1000",
    "message": "Message content is empty, exceeds length limit, or contains forbidden content",
    "http": 400
  }
}

MessagesCHAT_1000-1099

Code	HTTP	Name	Description	Resolution
`CHAT_1000`	400	`INVALID_MESSAGE`	Message content is empty, exceeds length limit, or contains forbidden content	Check message content length (max 10,000 characters)
`CHAT_1001`	404	`MESSAGE_NOT_FOUND`	The specified message does not exist or is not accessible	Verify the message ID and thread membership
`CHAT_1002`	403	`MESSAGE_EDIT_FORBIDDEN`	Cannot edit a message you did not author	Only the original sender can edit a message
`CHAT_1003`	400	`ATTACHMENT_TOO_LARGE`	Attachment exceeds maximum file size	Reduce attachment size (max 25 MB per file)
`CHAT_1004`	400	`UNSUPPORTED_MESSAGE_TYPE`	The specified message type is not supported	Use a valid type: text, image, file, audio, video, system

ThreadsCHAT_1100-1199

Code	HTTP	Name	Description	Resolution
`CHAT_1100`	404	`THREAD_NOT_FOUND`	The specified thread does not exist or is not accessible	Verify the thread ID and user membership
`CHAT_1101`	403	`NOT_THREAD_MEMBER`	You are not a member of this thread	Request access or join the thread first
`CHAT_1102`	409	`THREAD_ARCHIVED`	Cannot send messages to an archived thread	Unarchive the thread before sending messages
`CHAT_1103`	400	`INVALID_THREAD_TYPE`	Thread type is not valid	Use a valid type: direct, group, channel

ReactionsCHAT_1200-1299

Code	HTTP	Name	Description	Resolution
`CHAT_1200`	400	`INVALID_EMOJI`	The specified emoji is not a valid Unicode emoji	Use a standard Unicode emoji character
`CHAT_1201`	409	`REACTION_EXISTS`	You already reacted with this emoji on this message	Remove the existing reaction before adding the same one

ModerationCHAT_1300-1399

Code	HTTP	Name	Description	Resolution
`CHAT_1300`	403	`USER_BLOCKED`	You have been blocked by this user or in this thread	Contact an admin to resolve the block
`CHAT_1301`	403	`CONTENT_BLOCKED`	Message flagged by content moderation (DLP)	Remove sensitive or prohibited content from the message
`CHAT_1302`	404	`REPORT_NOT_FOUND`	The specified moderation report does not exist	Verify the report ID

AI FeaturesCHAT_1400-1499

Code	HTTP	Name	Description	Resolution
`CHAT_1400`	402	`INSUFFICIENT_AI_CREDITS`	Insufficient AI credits for this operation	Purchase additional credits or upgrade subscription tier
`CHAT_1401`	503	`AI_SERVICE_UNAVAILABLE`	AI service (llm-orch-svc) is temporarily unavailable	Retry after a short delay
`CHAT_1402`	400	`TRANSLATE_UNSUPPORTED_LANGUAGE`	Target language is not supported for translation	Use a supported ISO 639-1 language code

AuthenticationCHAT_1500-1599

Code	HTTP	Name	Description	Resolution
`CHAT_1500`	401	`UNAUTHORIZED`	Authentication required	Provide a valid JWT token in Authorization header
`CHAT_1501`	403	`FORBIDDEN`	Insufficient permissions for this operation	Request required role from admin
`CHAT_1502`	401	`INVALID_TOKEN`	Invalid or expired authentication token	Obtain a fresh JWT token via auth-svc

ValidationCHAT_1600-1699

Code	HTTP	Name	Description	Resolution
`CHAT_1600`	400	`VALIDATION_FAILED`	Request validation failed	Check request body against API docs
`CHAT_1601`	400	`MISSING_REQUIRED_FIELD`	Required field is missing from the request	Add the required field to the request body

WebSocketCHAT_1700-1799

Code	HTTP	Name	Description	Resolution
`CHAT_1700`	401	`WS_AUTH_FAILED`	WebSocket authentication failed	Provide a valid JWT token in the auth handshake
`CHAT_1701`	429	`WS_RATE_LIMITED`	WebSocket message rate limit exceeded	Reduce message frequency; wait before retrying

GeneralCHAT_1800-1899

Code	HTTP	Name	Description	Resolution
`CHAT_1800`	500	`INTERNAL_SERVER_ERROR`	Internal server error	Retry; if persistent, contact support with request_id
`CHAT_1801`	503	`SERVICE_UNAVAILABLE`	Service temporarily unavailable	Retry with exponential backoff
`CHAT_1802`	504	`TIMEOUT`	Request timeout	Reduce request complexity or retry