Rumora

When a call fails, REST returns JSON of this shape. MCP tools return the same code values. HTTP status applies to REST only.

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing or invalid Bearer token."
  }
}

Extra fields may appear next to code and message:

PAYMENT_REQUIRED includes checkout_url, credits_needed, and credits_have.
CONFLICT includes job_id.
QUANTITY includes min and max.
PARSE on over-length text includes max.

Code	HTTP	When it happens
`UNAUTHORIZED`	401	Missing, unknown, or revoked Bearer token
`PAYMENT_REQUIRED`	402	Not enough credits
`HELD`	403	Workspace is held
`FORBIDDEN`	403	Find on a workspace without an active paid plan
`OPTED_OUT`	403	The video owner opted out
`NOT_FOUND`	404	Unknown route, thread, or job
`CONFLICT`	409	A Find job is already open
`RATE_LIMIT`	429	10 write tools in the last 60 seconds
`PARSE`	400	Body failed validation
`QUANTITY`	400	Like quantity below min or above max
`PLATFORM`	400	URL is not YouTube or TikTok
`PROVIDER`	400	That action is not available, or Rumora could not complete it

Do this when you see the code. Symptom-first steps are in Troubleshooting.

Code	What you do
`UNAUTHORIZED`	Mint a key on API keys. Send `Authorization: Bearer rmr_...` with the full secret.
`PAYMENT_REQUIRED`	Open `checkout_url`. Buy a plan or pack. Retry with the same `idempotency_key`.
`HELD`	Contact support. Mutating commands stay blocked until the hold clears.
`FORBIDDEN`	Start a paid plan, or paste a URL and post without Find.
`OPTED_OUT`	Pick a different video. Existing live comments stay.
`NOT_FOUND`	Check the path and copy `id` from the previous success JSON.
`CONFLICT`	Poll `get_status` on `job_id`. Wait until that job finishes.
`RATE_LIMIT`	Wait, then retry with the same `idempotency_key`. Reads are not counted.
`PARSE`	Fix the field named in `message`. Call `get_usage` for live max length.
`QUANTITY`	Send at least `min` from the error body. Rumora will not raise a low quantity.
`PLATFORM`	Pass a YouTube watch or Shorts URL, or a TikTok video URL.
`PROVIDER`	Call `get_usage`. If `canComment`, `canReply`, or `canLike` is false, that action is unavailable.

Errors