> ## Documentation Index
> Fetch the complete documentation index at: https://api.watermelonn.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

> Common HTTP and WebSocket errors returned by the platform API.

## 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.  |

## Common error payloads

```json theme={null}
{ "error": "Missing or invalid authorization header" }
```

```json theme={null}
{ "error": "Conversation not found" }
```

```json theme={null}
{ "success": false, "error": "Failed to create support ticket" }
```

## WebSocket errors

WebSocket protocol errors are sent as message type `error`:

```json theme={null}
{
  "type": "error",
  "payload": {
    "message": "Invalid message format"
  }
}
```