06 / RESPONSES

Limits & useful errors

Constraint	Limit
JSON request / generated response	20 MiB / 32 MiB
Imported PDF / merged output	10 MB per PDF / 500 pages total
PDFs in one merge call	25
Default generation rate	30 requests per minute per IP
Default concurrent generations	2, with a queue of 8
Default rendering deadline	60 seconds; cooperative cancellation

Status	Action
`400` Invalid request	Read the JSON `errors` map and correct the indicated fields. Use the HTTPS URL for HTTPS required errors.
`401` Unauthorized	Supply the deployment's API key.
`403` Forbidden	Check the allowed origins for this deployment.
`404` Unknown template	Retrieve a valid ID from the template catalog.
`408` Deadline exceeded	Reduce the workload; rendering cancellation is cooperative.
`413 / 415`	Reduce request size / send JSON with the correct content type.
`429` Too many requests	Respect `Retry-After` when provided.
`500` Server error	Use the trace identifier to investigate server logs.

JSON · example validation response

{
  "title": "Invalid PDF operation",
  "status": 400,
  "errors": { "documents[0].pages[0]": ["Use a page number between 1 and 3."] }
}