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

# Status Codes

> HTTP status codes and error handling in the Cometly API

## Overview

The Cometly API uses conventional HTTP response codes to indicate the success or failure of an API request. Codes in the `2xx` range indicate success, and codes in the `4xx` range indicate an error with the request.

## HTTP Status Code Summary

| Status Code | Description                                                                     |
| ----------- | ------------------------------------------------------------------------------- |
| 200         | OK - The request was successful                                                 |
| 201         | Created - The resource was successfully created                                 |
| 202         | Accepted - The request has been queued for processing successfully              |
| 401         | Unauthenticated - Authentication failed or wasn't provided                      |
| 403         | Forbidden - The request is understood but refused                               |
| 404         | Not Found - The requested resource does not exist                               |
| 422         | Unprocessable Entity - Request validation failed or missing required parameters |

## Error Response Structure

All error responses follow a consistent structure:

```json theme={null}
{
  "message": "Human-readable error message"
}
```

| Field     | Type   | Description                      |
| --------- | ------ | -------------------------------- |
| `message` | string | Human-readable error description |