Errors

json

{ "error": { "code": "validation_failed", "message": "Request validation failed", "details": { "issues": [{ "path": "name", "code": "too_small", "message": "..." }] } } }

Code	HTTP	Meaning
`bad_request`	400	Malformed JSON, bad cursor or unsupported version
`unauthenticated`	401	Missing or invalid credential
`entitlement_exceeded`	402	Plan limit reached
`forbidden`	403	Role or scope does not allow this
`not_found`	404	Missing, or in another workspace
`conflict`	409	Draft revision conflict, slug taken, idempotency mismatch, form closed or full
`payload_too_large`	413	Body over 2 MB
`validation_failed`	422	Invalid input; see details.issues, details.fields or publish details.issues
`rate_limited`	429	Slow down; see Retry-After
`internal`	500	Our fault; quote X-Request-Id
`unsupported`	501	Not implemented
`integration_error`	502	Upstream provider failed

Draft conflicts return details.currentRevision; refetch, merge and retry with that revision. Closed forms return details.reason: closed, expired, max_responses, quota_full or already_responded.