# Errors

URL: https://www.agencytitan.com/docs/tag/errors

The API uses conventional HTTP status codes: `2xx` for success, `4xx` for a problem with the request, and `5xx` for an error on our side. Requests are strictly validated: unknown or out-of-range query parameters and body properties are rejected with a `400`.

Most errors return the standard envelope, whose `type` field you can branch on. The `type` is one of `validation_error`, `permission_denied`, `not_found`, `conflict`, `rate_limited`, or `internal`. Authentication failures (`401`) use an OAuth-style shape instead. Both shapes are shown alongside.

**Error envelope**

```json
{
  "error": {
    "type": "validation_error",
    "message": "Human-readable description."
  }
}
```

**Authentication error (401)**

```json
{
  "error": "invalid_token",
  "error_description": "..."
}
```

**Status codes:** `400` validation failed, `401` missing or invalid token, `403` insufficient permission, `404` not found, `409` conflict, `429` rate limited, `500` internal error.

## Operations

_This tag has no REST operations (guide / concept page)._

## Useful links

- Interactive page: https://www.agencytitan.com/docs/tag/errors
- API reference home: https://www.agencytitan.com/docs/
- This page as Markdown: https://www.agencytitan.com/docs/tag/errors.md
- Full API Markdown: https://api.agencytitan.com/v1/llms.txt