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

# API Errors

> Error codes and responses

All errors return JSON:

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

| Code | HTTP | Description |
| - | - | - |
| `UNAUTHORIZED` | 401 | Invalid or missing credentials |
| `INSUFFICIENT_SCOPE` | 403 | Scope not granted on key/token |
| `SITE_NOT_LICENSED` | 403 | Site requires active license |
| `SITE_NOT_FOUND` | 404 | Site not in team |
| `NOT_FOUND` | 404 | Resource not found |
| `VALIDATION_ERROR` | 400 | Invalid request body |
| `RATE_LIMITED` | 429 | Too many requests |
| `AGENT_NOT_ENTITLED` | 402 | Automations not available on the team's plan (or insufficient AI credits) |
| `CREDITS_EXHAUSTED` | 402 | Team AI credit pool exhausted |
| `ARTICLE_LIMIT` | 403 | Article quota exhausted (when credit enforcement is off) |
| `MODULE_REQUIRED` | 402 | The site's team does not have the module the endpoint belongs to (SEO module endpoints and MCP tools) |
| `REFRESH_COOLDOWN` | 409 | A manual SEO refresh came sooner than the plan's refresh gap allows; `retryAt` says when the next one can run. Scheduled checks keep the data current |
| `BUDGET_EXHAUSTED` | 429 | The site's daily lookup budget is spent; paid SEO lookups and refreshes resume at 00:00 UTC |


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