Rush API

Error codes

Every error is JSON with a stable code to branch on and a message to show. These are the 62 codes the operations document.

View .md

The error body

Every non-2xx body. Two envelopes are live: most routes send error (a sentence) with an optional code or error_code; the org-wide session search sends code and message. Some refusals add fields (candidates, fields, plan usage). Branch on code / error_code.

errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, TOKEN_LIMIT_REACHED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional

Every code

CodeStatusSent by
ATTACHMENT_EXPIRED410Start a session
ATTACHMENT_IN_USE409Start a session, Send a follow-up
ATTACHMENT_NOT_FOUND404Start a session
ATTACHMENT_NOT_UPLOADED409Start a session, Send a follow-up
CANCELLATION_UNCONFIRMED503Cancel a session
CATALOG_REFRESH_REQUIRED409Start a session
COMPUTE_LIMIT_REACHED402Start a session
CONNECTION_AMBIGUOUS422Start a session, Save an agent.
CONNECTION_NOT_READY422Start a session, Save an agent.
CONNECTION_UNAVAILABLE422Send a follow-up
CONTENT_TOO_LARGE400Send a follow-up
CONTINUATION_UNSUPPORTED409Send a follow-up
FIELD_REMOVED400Start a session, Send a follow-up, Save an agent.
FORBIDDEN403Send a follow-up
IDEMPOTENCY_CONFLICT409Start a session, Save an agent.
IF_MATCH_REQUIRED428Delete a saved agent.
IMMUTABLE_FIELD422Edit a saved agent.
INPUT_FETCH_FAILED422Start a session, Send a follow-up
INSTALLATION_NOT_LINKED403Start a session
INVALID_BODY400Start a session, Send a follow-up, Get an upload URL for each file of a session's input.
INVALID_DESCRIPTION422Save an agent.
INVALID_EFFORT422Save an agent.
INVALID_FILTER400Read a session's transcript
INVALID_HARNESS422Save an agent.
INVALID_INSTRUCTIONS422Save an agent.
INVALID_MODEL422Save an agent.
INVALID_NAME422Save an agent.
MCP_SERVER_URL_INVALID422Start a session
MODEL_UNSUPPORTED422Start a session
NOT_FOUND404Read a session's transcript, Get one of your saved agents., Edit a saved agent., Delete a saved agent.
PAYMENT_METHOD_REQUIRED402Start a session
PROJECT_PAUSED409Send a follow-up
RATE_LIMITED429Start a session
REPO_NOT_IN_INSTALLATION403Start a session
REQUEST_TOO_LARGE413Start a session, Send a follow-up
RESOURCE_NOT_ACCESSIBLE422Start a session
RESOURCE_UNSUPPORTED422Start a session
RUN_STATE_CONFLICT409Cancel a session
SECRET_DESCRIPTION_INVALID422Save a secret. The value is sealed and never returned., Replace a secret's value or note.
SECRET_FIELD_IMMUTABLE422Replace a secret's value or note.
SECRET_KIND_INVALID422Save a secret. The value is sealed and never returned.
SECRET_NAME_INVALID422Save a secret. The value is sealed and never returned.
SECRET_NAME_TAKEN409Save a secret. The value is sealed and never returned.
SECRET_NOT_FOUND404Replace a secret's value or note., Delete a secret. A session that names it afterwards fails instead of starting without it.
SECRET_PROJECT_NOT_IN_ORG422Save a secret. The value is sealed and never returned.
SECRET_PROJECT_REQUIRED422Save a secret. The value is sealed and never returned.
SECRET_TARGET_INVALID422Save a secret. The value is sealed and never returned.
SECRET_VALUE_INVALID422Save a secret. The value is sealed and never returned., Replace a secret's value or note.
SESSION_NOT_CAPTURED404Read a session's transcript
SKILL_FETCH_FAILED422Start a session, Save an agent.
SKILL_INVALID422Start a session, Save an agent.
SPEND_CAP_REACHED402Start a session
STALE_ETAG412Edit a saved agent., Delete a saved agent.
TASK_TERMINAL409Send a follow-up
TOKEN_LIMIT_REACHED402Start a session
TOO_MANY_FILES400Get an upload URL for each file of a session's input.
TURN_ACTIVE409Send a follow-up
UNKNOWN_FIELD400Start a session, Save an agent.
UNSUPPORTED_AGENT422Start a session
UNSUPPORTED_PROFILE422Save an agent.
VALIDATION_ERROR400Create an API key, Set, change or remove the key's webhook
WEEKLY_COMPUTE_LIMIT_REACHED402Start a session