Path parameters
The org's slug or id. A caller with no role in the org gets 404.
The session's full id (execution_id).
Responses
200The session.
The session id.
The org as the request's path named it.
The Project the console ran the session in.
paused is a resumable session parked between turns; needs_review finished without the proof it was asked for; cancelling appears only in the 202 answer to a cancel whose sandbox is still being released; GET reads cancelled once it is.
queuedallocatingrunningpausedinput_requiredneeds_reviewcompletedfailedcancellingcancelledexpiredclaude, codex or opencode.
The saved agent the session was started from, if any.
The agent's final answer for the last finished turn, in full.
Only on a follow-up's answer: the turn the message opened, running or waiting in line (queued).
2 fields
runningqueuedWhat the last finished turn did, written from result when it finished: the line Rush's notifications lead with. Absent when the turn left no answer.
2 fields
Why a failed or expired run ended. message is a sentence a person can act on.
2 fields
A plan or account limit the run hit (FREE_TRIAL_USED, PLAN_REQUIRED, TOKEN_LIMIT_REACHED, CREDITS_EXHAUSTED, SPEND_CAP_REACHED, COMPUTE_LIMIT_REACHED, WEEKLY_COMPUTE_LIMIT_REACHED, PAYMENT_METHOD_REQUIRED), the model account it used (PROVIDER_AUTH_FAILED, PROVIDER_RATE_LIMITED, MODEL_ACCOUNT_MISSING), how it ended (HARNESS_EXITED, RUN_STALLED, RUN_TIMED_OUT, RUN_START_FAILED, MACHINE_UNAVAILABLE, MACHINE_REFUSED, MACHINE_LOST, LEASE_EXPIRED, SAVED_STATE_EXPIRED, BRANCH_NOT_FOUND, AGENT_UNAVAILABLE, CONNECTION_UNAVAILABLE, AUTH_FAILED), or RUN_FAILED. Runs that failed before codes were recorded read RUN_FAILED.
Uncached input plus cache writes plus output.
Every file the agent saved to /workspace/.rush/artifacts/. url downloads it from this
API with no credential until url_expires_at, an hour after the read; read the session
again for a fresh link. GET …/artifacts/{name} with the key also downloads it.
4 item fields
A signed https link to the file on this API.
The files the session was started or followed up with. url downloads one with no
credential until url_expires_at, as for artifacts; GET …/attachments/{id} with the
key also downloads it.
5 item fields
A signed https link to the file on this API.
The connections the session's tokens acted as, one entry per account however often it
was used, with when it was first used: a signed-in app account (oauth) or an MCP server
signed as one person (mcp); a connection added to the Project for its members is not
listed, so its sessions stay readable by the team. The session's agent_id
says whose agent it was. Absent when the session used none, and for sessions started
before accounts were recorded. Never a token.
5 item fields
oauthmcpFor oauth the app vendor (google, microsoft, buffer, quickbooks); for mcp the server's name.
For oauth the account's email (for QuickBooks, the company's realm id); for mcp the connection's id, or the server's host when the session supplied its own token.
The account's products the session reached, such as gmail or outlook. Absent for mcp.
401No bearer, an unknown, revoked or expired one, or an API key on a route keys cannot call.
A sentence for a person.
Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, TOKEN_LIMIT_REACHED.
The machine code on routes that name it this way.
404No such resource for the caller, including one in an org the caller is not in or a Project that is private to someone else.
A sentence for a person.
Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, TOKEN_LIMIT_REACHED.
The machine code on routes that name it this way.
429The account is over its request budget, 1,800 a minute shared by the person's API keys and console on every API host (RATE_LIMITED).
The account is over its request budget, 1,800 a minute shared by the person's API keys and console on every API host (RATE_LIMITED). The error names the limit. Wait Retry-After seconds.
A sentence for a person.
Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, TOKEN_LIMIT_REACHED.
The machine code on routes that name it this way.