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

# Errors

> HTTP status codes and error response format

The Ruddr API uses standard HTTP status codes to indicate the success or failure of a request.

## Status Codes

### Success

| Code | Description |
| - | - |
| `200 OK` | Everything worked as expected. |
| `204 No Content` | Everything worked as expected, but there is no content to return. Typical for delete requests. |

### Client Errors

| Code | Description |
| - | - |
| `400 Bad Request` | The request was unacceptable due to an issue with the request format or data. |
| `401 Unauthorized` | The API key is missing or invalid. |
| `403 Forbidden` | The requested feature is not enabled for this workspace. |
| `404 Not Found` | The resource or endpoint does not exist. |
| `405 Method Not Allowed` | The endpoint URL exists, but does not support the requested operation. |
| `409 Conflict` | A resource with the same identifying information already exists, or the resource is read-only. |
| `423 Locked` | API access is disabled for this workspace. Contact support for assistance. |
| `429 Too Many Requests` | Rate limit exceeded. See [Rate Limits](/guides/rate-limits) for retry guidance. |

### Server Errors

| Code | Description |
| - | - |
| `500 Internal Server Error` | Something went wrong on Ruddr's end. |

## Error Response Format

Error responses return a JSON object with a `status` code and descriptive `message`:

```json theme={null}
{
  "status": 400,
  "message": "Parameter 'id' is not a valid UUID."
}
```

Some validation errors may include an `errors` array with details:

```json theme={null}
{
  "status": 400,
  "message": "There was a problem processing your request. See errors for more details.",
  "errors": ["'name' is required"]
}
```


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