payload_too_large (413)

← Error reference

payload_too_large

HTTP status: 413

Retryable: No — retrying without changes will fail the same way.

The request body exceeded the per-endpoint size limit.

When it fires

JSON bodies are capped at 1 MiB. File-style endpoints publish their own larger limit in the reference.

How to handle it

Split the payload, or upload large blobs (e.g. document images) via the dedicated upload endpoints rather than embedding them as base64.

Example response

{
  "error": {
    "type": "https://docs-dev.autohost-dev.uk/api/errors/payload_too_large",
    "code": "payload_too_large",
    "message": "Request body exceeds 1048576 bytes",
    "request_id": "req_01HEXAMPLE0000000000000000",
    "doc_url": "https://docs-dev.autohost-dev.uk/api/errors/payload_too_large"
  }
}