Platform

Error reference

Every error code the platform returns.

All errors share one envelope (error.message, error.type, error.code). The codes you may encounter:

Status	Code	Where
`400`	`bad_request`	Malformed input — the message says exactly what to fix.
`401`	`unauthorized`	Missing, revoked or expired key; signed-out session.
`402`	`budget_exceeded`	Hard spend cap reached for the period.
`403`	`forbidden`	Key lacks the required scope, or the account is suspended.
`404`	`not_found`	No such resource for you — Roar never reveals whether it exists for someone else.
`413`	`request_too_large`	Inference body over 10MB; audio uploads over 50MB.
`422`	`guardrail_blocked`	Account guardrails stopped sensitive data leaving.
`429`	`rate_limit_exceeded`	Requests/min, tokens/min or concurrency cap. Has `retry-after`.
`502`	`upstream_error`	All candidate backends failed; safe to retry.
`504`	`upstream_timeout`	The model took too long; safe to retry.

Include the x-roar-request-id response header when contacting support.