> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

> [!WARNING]
>
> **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](/api-reference/hosts) and obtain your deployment URL and credentials.
> Replace the example host if your provisioned service uses a different URL.

### Path parameters

**id** `string (uuid)` *required*

Sandbox identifier

**processId** `string` *required*

Process identifier (proc\_...)

### Query parameters

**tail\_bytes** `integer`

Maximum tail bytes per stream; base64 preserves binary output. No process mutations.

### Response

`ProcessResult`

**sandbox\_id** `string (uuid)` *required*

**process\_id** `string` *required*

**name** `string`

**status** `string` *required*

**exit\_code** `integer,null` *required*

Minimum: `-9007199254740991`. Maximum: `9007199254740991`.

**signal** `string,null` *required*

**restarts** `integer` *required*

Minimum: `0`. Maximum: `9007199254740991`.

**started\_at** `string,null` *required*

**exited\_at** `string,null` *required*

**outcome** `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'`.

**complete** `boolean` *required*

A stable terminal process and its final log ends were verified; output can still be truncated.

**output\_capture\_failed** `boolean` *required*

The exec agent reported a log capture failure; available output may be incomplete.

**observed\_at** `string (date-time)` *required*

**stdout** `object` *required*

**stdout**

**process\_id** `string` *required*

**stream** `string` *required*

Allowed values: `'stdout'`, `'stderr'`.

**offset** `integer` *required*

Minimum: `0`. Maximum: `9007199254740991`.

**next\_offset** `integer` *required*

Minimum: `0`. Maximum: `9007199254740991`.

**end\_offset** `integer` *required*

Minimum: `0`. Maximum: `9007199254740991`.

**earliest\_offset** `integer` *required*

Minimum: `0`. Maximum: `9007199254740991`.

**eof** `boolean` *required*

**truncated** `boolean` *required*

Some output was omitted by the tail budget, rotation, or an incomplete read.

**data** `string` *required*

Base64 output bytes; decode as UTF-8 only for text workers.

**status** `string` *required*

**stderr** `object` *required*

**stderr**

**process\_id** `string` *required*

**stream** `string` *required*

Allowed values: `'stdout'`, `'stderr'`.

**offset** `integer` *required*

Minimum: `0`. Maximum: `9007199254740991`.

**next\_offset** `integer` *required*

Minimum: `0`. Maximum: `9007199254740991`.

**end\_offset** `integer` *required*

Minimum: `0`. Maximum: `9007199254740991`.

**earliest\_offset** `integer` *required*

Minimum: `0`. Maximum: `9007199254740991`.

**eof** `boolean` *required*

**truncated** `boolean` *required*

Some output was omitted by the tail budget, rotation, or an incomplete read.

**data** `string` *required*

Base64 output bytes; decode as UTF-8 only for text workers.

**status** `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](/spec/sandbox.json) for declared schemas and alternatives.
This page also includes documented corrections from the [spec overlays](https://github.com/stateset/docs/tree/main/spec/overlays).
Example IDs and values are illustrative; replace them with records from your workspace.

```bash cURL theme={null}
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'
```

```json 200 theme={null}
{
  "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"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.