Skip to content
Hayonix

API reference · Schema

SandboxRun

  • 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)

Example
{
  "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"
}

Used by