curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.sandbox.stateset.app/api/v1/sandbox/{id}/processes/{processId}/result' \
--header 'Authorization: ApiKey YOUR_API_KEY'
{
"sandbox_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"process_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Two-Person Tent",
"status": "pending",
"exit_code": 1,
"signal": "string",
"restarts": 1,
"started_at": "2026-08-31T14:22:05Z",
"exited_at": "2026-08-31T14:22:05Z",
"outcome": "pending",
"complete": true,
"output_capture_failed": true,
"observed_at": "2026-08-31T14:22:05Z",
"stdout": {
"process_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stream": "stdout",
"offset": 1,
"next_offset": 1,
"end_offset": 1,
"earliest_offset": 1,
"eof": true,
"truncated": true,
"data": "string",
"status": "pending"
},
"stderr": {
"process_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stream": "stdout",
"offset": 1,
"next_offset": 1,
"end_offset": 1,
"earliest_offset": 1,
"eof": true,
"truncated": true,
"data": "string",
"status": "pending"
}
}
Read a bounded worker result; incomplete snapshots are safe to read again
Process outcome and bounded stdout/stderr; complete=false requires a later read for a final result
GET
/
api
/
v1
/
sandbox
/
{id}
/
processes
/
{processId}
/
result
curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.sandbox.stateset.app/api/v1/sandbox/{id}/processes/{processId}/result' \
--header 'Authorization: ApiKey YOUR_API_KEY'
{
"sandbox_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"process_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Two-Person Tent",
"status": "pending",
"exit_code": 1,
"signal": "string",
"restarts": 1,
"started_at": "2026-08-31T14:22:05Z",
"exited_at": "2026-08-31T14:22:05Z",
"outcome": "pending",
"complete": true,
"output_capture_failed": true,
"observed_at": "2026-08-31T14:22:05Z",
"stdout": {
"process_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stream": "stdout",
"offset": 1,
"next_offset": 1,
"end_offset": 1,
"earliest_offset": 1,
"eof": true,
"truncated": true,
"data": "string",
"status": "pending"
},
"stderr": {
"process_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stream": "stdout",
"offset": 1,
"next_offset": 1,
"end_offset": 1,
"earliest_offset": 1,
"eof": true,
"truncated": true,
"data": "string",
"status": "pending"
}
}
Confirm your deployment before running this request. This page describes an API contract;
a published reference does not establish hosted availability. Check the dated
host report and obtain your deployment URL and credentials.
Replace the example host if your provisioned service uses a different URL.
Path parameters
string (uuid)
required
Sandbox identifier
string
required
Process identifier (proc_…)
Query parameters
integer
Maximum tail bytes per stream; base64 preserves binary output. No process mutations.
Response
ProcessResult
string (uuid)
required
string
required
string
string
required
integer,null
required
Minimum:
-9007199254740991. Maximum: 9007199254740991.string,null
required
integer
required
Minimum:
0. Maximum: 9007199254740991.string,null
required
string,null
required
string
required
Process outcome only; exit zero does not validate the semantic success of an agent task. Allowed values:
'pending', 'succeeded', 'failed', 'cancelled', 'timed_out', 'unknown'.boolean
required
A stable terminal process and its final log ends were verified; output can still be truncated.
boolean
required
The exec agent reported a log capture failure; available output may be incomplete.
string (date-time)
required
object
required
Show stdout
Show stdout
string
required
string
required
Allowed values:
'stdout', 'stderr'.integer
required
Minimum:
0. Maximum: 9007199254740991.integer
required
Minimum:
0. Maximum: 9007199254740991.integer
required
Minimum:
0. Maximum: 9007199254740991.integer
required
Minimum:
0. Maximum: 9007199254740991.boolean
required
boolean
required
Some output was omitted by the tail budget, rotation, or an incomplete read.
string
required
Base64 output bytes; decode as UTF-8 only for text workers.
string
required
object
required
Show stderr
Show stderr
string
required
string
required
Allowed values:
'stdout', 'stderr'.integer
required
Minimum:
0. Maximum: 9007199254740991.integer
required
Minimum:
0. Maximum: 9007199254740991.integer
required
Minimum:
0. Maximum: 9007199254740991.integer
required
Minimum:
0. Maximum: 9007199254740991.boolean
required
boolean
required
Some output was omitted by the tail budget, rotation, or an incomplete read.
string
required
Base64 output bytes; decode as UTF-8 only for text workers.
string
required
Status codes
| Code | Meaning |
|---|---|
200 | Process outcome and bounded stdout/stderr; complete=false requires a later read for a final result |
400 | Invalid query or identifiers |
401 | Authentication required |
403 | Read access denied |
404 | Sandbox or process not found |
409 | Sandbox is not running |
501 | Exec agent does not support supervised processes |
503 | Exec agent temporarily unavailable; retry the read |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.sandbox.stateset.app/api/v1/sandbox/{id}/processes/{processId}/result' \
--header 'Authorization: ApiKey YOUR_API_KEY'
{
"sandbox_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"process_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Two-Person Tent",
"status": "pending",
"exit_code": 1,
"signal": "string",
"restarts": 1,
"started_at": "2026-08-31T14:22:05Z",
"exited_at": "2026-08-31T14:22:05Z",
"outcome": "pending",
"complete": true,
"output_capture_failed": true,
"observed_at": "2026-08-31T14:22:05Z",
"stdout": {
"process_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stream": "stdout",
"offset": 1,
"next_offset": 1,
"end_offset": 1,
"earliest_offset": 1,
"eof": true,
"truncated": true,
"data": "string",
"status": "pending"
},
"stderr": {
"process_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"stream": "stdout",
"offset": 1,
"next_offset": 1,
"end_offset": 1,
"earliest_offset": 1,
"eof": true,
"truncated": true,
"data": "string",
"status": "pending"
}
}
Last modified on October 20, 2026