Errors

Error envelope:

{ "error": { "code": "...", "message": "..." }, "meta": { "request_id": "..." } }

Code	HTTP	Meaning
unauthorized	401	Missing/invalid Authorization header
forbidden	403	Authenticated but lacks scope or pilot enrollment
not_found	404	Resource doesn't exist or doesn't belong to your store
bad_request	400	Validation error; see message and optional details
method_not_allowed	405	Path exists for another method
rate_limited	429	Per-minute limit; Retry-After header included
quota_exceeded	402	Monthly cap hit; upgrade or wait
server_error	500	Unexpected origin error; safe to retry idempotent calls

Always include meta.request_id when contacting support.