Skip to content
Hayonix

API reference · Sandboxes

Runs of a sandbox, newest first (kept until 7 days after it ends)

GET/v1/sandboxes/{sandbox_id}/runs
API keysandbox:readProjectPaginated
TypeScript
client.sandboxes.listRuns()
Python
client.sandboxes.list_runs()
CLI
hayonix sandboxes runs list

Every run with its outcome and the first 65536 bytes of each of stdout and stderr.

Project API key (Authorization: Bearer sk_…), or a console session. Requires the sandbox:read permission (a key's scope, or a role that includes it).

Examples

The samples read API_KEY and API_BASE_URL from the environment (see Setup). Values are examples.

curl -sS "$API_BASE_URL/sandboxes/sbx_01jc5zq4m8k3v6x9t2w7r0b1e4/runs" \
  -H "Authorization: Bearer $API_KEY"

Request

Headers
HeaderRequiredDescription
AuthorizationyesBearer and your API key. The key implies its project.
X-Project-Idsession onlyThe project to act in, for console sessions. Requests with an API key leave it out.

Path parameters

  • sandbox_idstringrequired

    ID of the sandbox

    ID with prefix sbx_

Query parameters

  • limitinteger

    1–200, default 50

    1–200

  • cursorstring

    `next_cursor` of the previous page

    up to 200 characters

Response

200 a page of results — A page of runs

  • The items of this page.

    Show 20 fields of data
    • objectstringrequired

      Always `sandbox_run`: the type of this object

      One ofsandbox_run

    • idstringrequired

      Unique ID (`sbr_…`)

      ID with prefix sbr_

    • sandbox_idstringrequired

      ID of the sandbox

      ID with prefix sbx_

    • languagestringrequired

      Language the code ran as

      One ofpythonjavascriptshell

    • statestringrequired

      queued | running | completed (it ran: see exit_code and cut_off) | error (it could not run: see error)

      One ofqueuedrunningcompletederror

    • outcomestring | nullrequired

      One word for how it ended (null while queued or running)

      One ofsucceededfailedtime_limitoutput_limitout_of_memorycancelledsandbox_endederror

    • exit_codeinteger | nullrequired

      Exit status of the code (0 means success); null until it finishes, or when it could not run

    • cut_offstring | nullrequired

      Why it was stopped before it finished: time_limit | output_limit | out_of_memory | cancelled | sandbox_ended

      One oftime_limitoutput_limitout_of_memorycancelledsandbox_ended

    • state_resetbooleanrequired

      The Python interpreter had to be restarted: variables from earlier runs are gone

    • errorstring | nullrequired

      Why the run could not run or was stopped, for people; null otherwise

    • stdoutstringrequired

      Standard output (see `output.truncated`)

    • stderrstringrequired

      Standard error (see `output.truncated`)

    • outputobjectrequired

      How much output the run produced

      Show 3 fields of output
      • stdout_bytesintegerrequired

        Bytes the run wrote to standard output

      • stderr_bytesintegerrequired

        Bytes the run wrote to standard error

      • truncatedbooleanrequired

        stdout and stderr above are the run's whole output (up to its cap) in the response to the run itself, and the first 65536 bytes of each in the record kept for 7 days after the sandbox ends; true when this copy is shorter than what the run produced

    • codestringrequired

      Machine-readable code

    • timeout_secondsintegerrequired

      Time limit the run had, in seconds

    • max_output_bytesintegerrequired

      Cap on stdout plus stderr the run had, in bytes

    • duration_msinteger | nullrequired

      How long it ran, in milliseconds; null until it finishes

    • created_atstring (date-time)required

      When it was created (ISO 8601, UTC)

    • started_atstring (date-time) | nullrequired

      When it started (null until then) (ISO 8601, UTC)

    • finished_atstring (date-time) | nullrequired

      When it finished (null until then) (ISO 8601, UTC)

  • next_cursorstring | nullrequired

    Pass as `cursor` for the next page; null on the last page.

Example response
Example response
{
  "data": [
    {
      "object": "sandbox_run",
      "id": "sbr_01jc5zq4m8k3v6x9t2w7r0b1e4",
      "sandbox_id": "sbx_01jc5zq4m8k3v6x9t2w7r0b1e4",
      "language": "python",
      "state": "queued",
      "outcome": "succeeded",
      "exit_code": 1,
      "cut_off": "time_limit",
      "state_reset": true,
      "error": "string",
      "stdout": "string",
      "stderr": "string",
      "output": {
        "stdout_bytes": 1,
        "stderr_bytes": 1,
        "truncated": true
      },
      "code": "string",
      "timeout_seconds": 1,
      "max_output_bytes": 1,
      "duration_ms": 1,
      "created_at": "2026-01-01T00:00:00.000Z",
      "started_at": "2026-01-01T00:00:00.000Z",
      "finished_at": "2026-01-01T00:00:00.000Z"
    }
  ],
  "next_cursor": "string"
}

Errors

Errors use the standard envelope. What this operation can answer:

Errors
StatusTypeWhen
400invalid_request_errorA parameter or body field is missing or not allowed; param names it.
401authentication_errorThe key or session is missing, revoked or expired.
403permission_errorThe credential lacks the permission this needs, or the organization is suspended.
404not_found_errorNo such resource in this project (an ID from another project is answered the same way).
429rate_limit_error rate_limitedToo many requests; retry after retry-after seconds.