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

# Error Handling

> Understanding Skaala API error responses and how to handle them

# Error Handling

The Skaala API uses conventional HTTP response codes to indicate success or failure.

## HTTP Status Codes

| Code | Meaning                                                |
| ---- | ------------------------------------------------------ |
| 200  | Success - Request completed successfully               |
| 201  | Created - Resource created successfully                |
| 400  | Bad Request - Invalid parameters or request body       |
| 401  | Unauthorized - Invalid or missing API key              |
| 403  | Forbidden - Valid API key but insufficient permissions |
| 404  | Not Found - Resource doesn't exist                     |
| 429  | Too Many Requests - Rate limit exceeded                |
| 500  | Server Error - Something went wrong on our end         |

## Error Response Format

```json theme={null}
{
  "error": "validation_error",
  "message": "Invalid request parameters",
  "fields": {
    "start_time": "Must be a valid ISO 8601 datetime"
  }
}
```