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

# Errors

> Error response shape and status codes used across the AmDital API.

## Error shape

Errors are returned as JSON with a consistent shape:

```json theme={null}
{
  "status": 400,
  "message": "Validation failed",
  "errors": [{ "path": ["email"], "message": "Invalid email address" }]
}
```

The top-level `errors` array (Zod validation issues) is only present on `400` validation errors.

## Status codes

| Status | Meaning |
| - | - |
| `400` | Validation error — request body/query failed schema validation |
| `401` | Authentication error — missing or invalid API key/session |
| `403` | Permission error — authenticated, but not authorized for this workspace/resource |
| `404` | Not found |
| `409` | Conflict — e.g. duplicate slug, stale update |
| `429` | Rate limited — see [Rate Limits](/rate-limits) |
| `500` | Server error |

Auth errors never reveal whether a resource or account exists — expect a generic message on `401`/`403` rather than a detailed reason.


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