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

# Errors

> Public API error format and status codes

# Errors

Failed requests return JSON:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "error": {
    "code": "invalid_credentials",
    "message": "Invalid API key",
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}
```

## Common codes

| HTTP | Code                              | Meaning                                                                           |
| ---- | --------------------------------- | --------------------------------------------------------------------------------- |
| 401  | `missing_credentials`             | No `Authorization: Bearer` header                                                 |
| 401  | `invalid_credentials`             | Key invalid or revoked                                                            |
| 403  | `forbidden_scope`                 | Key lacks required scope                                                          |
| 403  | `forbidden_entitlement`           | Your organization needs **Inform + Operate** (or a higher tier) for this endpoint |
| 404  | `not_found`                       | Resource not found (no cross-tenant leakage)                                      |
| 429  | `rate_limited` / `quota_exceeded` | Throttled                                                                         |
| 503  | `service_unavailable`             | Identity validation unavailable (fail closed)                                     |

Include `request_id` when contacting support.

For pagination on list endpoints, see [Pagination](/developers/pagination).
