error or detail field.
Error response shape
HTTP status codes
Error examples
401 — Invalid API key
Authorization header.
403 — Plan upgrade required
404 — Deployment not found
deployment_id either does not exist or belongs to a different user.
409 — Duplicate deployment
429 — Rate limit exceeded
retry_after_seconds before retrying. See also the Retry-After response header.
503 — Deployment not active
ACTIVE.
503 — Container unreachable
ACTIVE but did not respond. Usually resolves within seconds — retry with exponential backoff.
Handling errors — recommended pattern
Python
Node.js