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

# Errors

> Status codes and common error responses.

| Status | Meaning           | Usually                                                                   |
| ------ | ----------------- | ------------------------------------------------------------------------- |
| `200`  | OK                |                                                                           |
| `201`  | Created           |                                                                           |
| `400`  | Bad request       | A malformed body or parameter                                             |
| `401`  | Unauthorized      | Missing or invalid credentials or Authorization format                    |
| `403`  | Forbidden         | Account access denied, a missing key scope, or an insufficient role       |
| `404`  | Not found         | The id does not exist in **your** account                                 |
| `422`  | Unprocessable     | The body parsed but failed validation                                     |
| `429`  | Too many requests | See [rate limits](/rate-limits)                                           |
| `500`  | Server error      | Check the outcome before retrying a write; contact support if it persists |

## Shape

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

Many endpoints return an `error` string. Validation responses can include
additional or endpoint-specific details; check the endpoint contract.

<Note>
  An unauthorized account in the URL is rejected with `403`. Within an
  authorized account, contact and conversation lookups return `404` when the
  resource is absent from that account. Neither response grants access to
  another business's data, and `404` does not establish that an ID exists elsewhere.
</Note>