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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.