Get one session

GET/o/{org}/p/{project}/sessions/{session}
View .md

Path parameters

orgstringrequired

The org's slug or id. A caller with no role in the org gets 404.

projectstringrequired

A Project's handle (name) or id, resolved inside {org} — OR the reserved sentinel _ meaning "no Project" (a direct-repo / repo-less dispatch on POST; "no Project constraint, resolve by session id alone" everywhere else). A real handle that doesn't match the session's actual Project is 404.

sessionstringrequired

The session's full id (execution_id).

Responses

200The session.
execution_idstringrequired
kindstringrequired
One ofcloudlocal
org_idstring | nulloptional
Format uuid
project_idstring | nulloptional
Format uuid
agentstring | nulloptional

The harness.

statusstringrequired

paused is a resumable session parked between turns; needs_review finished without the proof it was asked for.

One ofqueuedallocatingrunningpausedinput_requiredneeds_reviewcompletedfailedcancelledexpired
persistence_modestring | nulloptional
One ofephemeralresumablenull
machine_statestring | nulloptional

The sandbox's own lifecycle (preparing, running, pausing, paused, resuming…), separate from status.

sandbox_generationinteger | nulloptional

Increments on every resume.

promptstring | nulloptional
repo_ownerstring | nulloptional
repo_namestring | nulloptional
branchstring | nulloptional
pr_urlstring | nulloptional
summarystring | nulloptional
errorstring | nulloptional
started_byobject | nulloptional
2 fields
namestring | nulloptional
avatar_urlstring | nulloptional
input_tokensinteger | nulloptional
output_tokensinteger | nulloptional
cache_read_tokensinteger | nulloptional
cache_write_tokensinteger | nulloptional
total_tokensinteger | nulloptional

Uncached input plus cache writes plus output; null when the run reported none.

reasoning_tokensinteger | nulloptional
total_cost_usdnumber | nulloptional
modelstring | nulloptional
tool_calls_countinteger | nulloptional
tool_errors_countinteger | nulloptional
turns_countinteger | nulloptional
files_producedinteger | nulloptional
attachmentsarray of objectoptional

Files the caller attached when starting the run.

5 item fields
idstringrequired
namestringrequired
mimestringrequired
sizeintegerrequired
expired_atstring | nullrequired
Format date-time
artifactsarray of ArtifactFileoptional

The first 6 artifacts; artifact_count has the total.

3 item fields
namestringrequired
sizeintegerrequired

Bytes.

content_typestringrequired
artifact_countintegeroptional
harness_version_requestedstring | nulloptional
harness_version_resolvedstring | nulloptional
profile_idstring | nulloptional

The saved agent the run started from.

profile_revisioninteger | nulloptional
profile_digeststring | nulloptional
requested_overridesobject | nulloptional
3 fields
modelstringoptional
effortstringoptional
speedstringoptional
agent_profileobject | nulloptional
2 fields
idstringoptional
namestringoptional
effectiveobject | nulloptional

What a saved-agent run actually ran with.

6 fields
modelstring | nulloptional
effortstring | nulloptional
speedstring | nulloptional
harness_versionstring | nulloptional
catalog_revisionstring | nulloptional
image_digeststring | nulloptional
snapshotobject | nulloptional

The saved-agent configuration the run was pinned to.

effective_configobject | nulloptional

What the sandbox loaded (harness version, plugins, hooks, commands), as the runtime reported it.

session_capturestring | nulloptional
One ofcompletepartialfailednull
created_atstringrequired
Format date-time
updated_atstring | nulloptional
Format date-time
401No bearer, an unknown, revoked or expired one, or an API key on a route keys cannot call.
errorstringoptional

A sentence for a person.

codestringoptional

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

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional
404No such resource for the caller, including one that exists in an org the caller cannot see.
errorstringoptional

A sentence for a person.

codestringoptional

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

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional