List the requests a sandbox made

GET /v1/sandboxes/{sandbox_id}/requests

Lists the requests code inside this sandbox made to B3OS in the last 7 days (its model calls, scrapes, searches and calls to other sandboxes), newest first, from the node's request log. These are the records GET /v1/requests?sandbox_id= lists, for a caller that may read the sandbox: it needs only sandboxes:read, not platform:read, and never returns another sandbox's records. It takes the same paging and the product, operation_id, status, trace_id and since filters; any other query parameter is 400 invalid_request. Requests made to the sandbox's public ports are not listed. A sandbox stopped more than 7 days ago is not found.

Authentication

Bearer Token (b3os_sk_ API key or b3os_pat_ token)

Path Parameters

sandbox_id string required path

The sandbox ID (sbx_…).

Pattern ^sbx_[0-9a-hjkmnp-tv-z]{26}$

Example: "sbx_01m5t68q1b590rj801nbzsqzkk"

Query Parameters

limit integer optional query

Page size, from 1 to 100.

Default 20Min 1Max 100

cursor string optional query

Opaque cursor from the previous page's next_cursor. Omit it for the first page.

Max length 512

product string optional query

Max length 32

operation_id string optional query

Max length 64

status string optional query

Only requests that succeeded (2xx) or failed (4xx, 5xx).

Values "2xx" "4xx" "5xx"

trace_id string optional query

Only requests of this W3C trace (the trace id of their traceparent).

Pattern ^[0-9a-f]{32}$

since string (date-time) optional query

Responses

200 A page of the sandbox's requests.

application/json

object string REQUIRED

Values list

data object[] REQUIRED

Array of:

id string REQUIRED

object string REQUIRED

Values request

method string REQUIRED

path string REQUIRED

The path without the query string.

operation_id string | null REQUIRED

product string | null REQUIRED

status_code integer REQUIRED

error_code string | null REQUIRED

error_detail string | null

Why a 4xx or 5xx answer failed, in the server's own words: the first 200 characters of its problem's detail (or a compatibility surface's message). null for a success, or when the server recorded none; absent from records written before it was recorded.

org_id string REQUIRED

project_id string REQUIRED

key_id string | null REQUIRED

The API key behind the request (for sandbox calls, the key that created the sandbox).

node string | null REQUIRED

The node that served it; null for a request the edge answered itself.

connection string REQUIRED

How the request reached B3OS: edge (through beta-api.b3os.org or the dashboard; forwarded to the node, or answered by the edge itself), uds (the node's Unix socket), tcp (the node's loopback TCP listener) or sandbox (from inside a sandbox, over vsock).

Values edge uds tcp sandbox

sandbox_id string | null REQUIRED

The calling sandbox, for sandbox connections; otherwise null.

started_at string (date-time) REQUIRED

duration_ms number REQUIRED

From the first request byte read to the last response byte written, measured on the node (at the edge for a request the edge answered itself); for streams, until the stream ended.

request_bytes integer REQUIRED

response_bytes integer REQUIRED

phases object[] REQUIRED

The node's phases (source: node) and the edge's edge_* phases (source: edge), in order.

Array of:

name string REQUIRED

source string REQUIRED

Values edge node

duration_ms number REQUIRED

trace_id string | null REQUIRED

The W3C trace ID from traceparent, when sent.

user_agent string | null REQUIRED

source string REQUIRED

Who made the request: api_key (an API key), cli_token (the CLI's device-login token), dashboard (a signed-in dashboard session; its successful reads are not logged, its changes and errors are), sandbox (code inside a sandbox, as its creating key), routine (a routine run, as the key that published its version), local (a host-local caller on the node's Unix socket), public (no credential: a webhook or signed callback to a public route, or a request refused before authentication), address (a visitor of an app address, <label>.b3os.io) or preview (a visitor of a sandbox port preview). address and preview records belong to the sandbox's project; their path is the app's path, without the query, cut at 1,024 bytes.

Values api_key cli_token dashboard sandbox routine local public address preview

next_cursor string | null REQUIRED

400 The request failed validation (invalid_request, invalid_url).

application/problem+json

type string (uri) REQUIRED

https://docs.beta.b3os.org/errors#<code>.

title string REQUIRED

Short summary of the problem type.

status integer REQUIRED

The HTTP status code, repeated for convenience.

code string REQUIRED

Stable machine-readable error code from the errors catalog.

detail string REQUIRED

Explanation of this occurrence. Never contains secrets.

instance string

The request ID (req_…) of the request that failed. Include it when you contact support.

errors object[]

Validation problems, one per field (invalid_request and the other codes that list errors).

Array of:

pointer string REQUIRED

Where the problem is: a JSON pointer into the request body (/url, /steps/0/uses), or #query/<name>, #path/<name> or #header/<name> for parameters.

detail string REQUIRED

What is wrong there.

reason string

Finer-grained cause for codes that document one (unauthorized, forbidden, egress_denied, upstream_unreachable, …).

required_scope string

The scope that was missing (forbidden with reason: scope).

retry_after_s integer

Same value as the Retry-After header, for clients that only read the body.

limit object

The limit an error refers to. IDs and current values are listed by GET /v1/limits.

id string REQUIRED

Limit ID, such as vision.scrape.rpm or sandboxes.concurrent.

limit number REQUIRED

The limit's value.

unit string REQUIRED

What the limit counts, such as requests, sandboxes, vcpu or MiB.

window_s integer

Window length in seconds for rate limits and quotas.

current number

Current usage against the limit, when known.

current_status string

The object's current status, for state conflicts such as sandbox_not_running.

upstream_status integer

The HTTP status the upstream returned (upstream_error, action_output_invalid).

step string

The failed step, as a step ID (routines), an index (act) or a path such as beats/2/do/0 (render).

pack_error object

The error a pack's error mapping chose (upstream_error from pack actions).

code string REQUIRED

message string REQUIRED

retryable boolean REQUIRED

option string

The option a request value was refused for, by its id (option_not_allowed), e.g. sandboxes.clone_reset.

value unknown

The value the request asked for (option_not_allowed).

allowed unknown[]

The values the request may ask for (option_not_allowed, an option with a closed list of values).

bound_by string

What set the bound a refused value is outside (option_not_allowed); node is the node's policy.

Values node org flag limit

service string

The application's service a refusal is about, with port (the address codes, app_host_*).

port integer

The port of service a refusal is about (the address codes, app_host_*).

exit_code integer

The exit status of a hosted tool's command (tool_failed with reason: exit).

signal string

The signal that ended a hosted tool's command, such as SIGKILL (tool_failed with reason: signal).

tool_code string

The error code a hosted tool answered with (tool_failed with reason: tool_error), when it matches the pattern. Text the tool wrote, not a B3OS code.

tool_message string

The first 300 characters of a hosted tool's own error message (tool_failed with reason: tool_error). Text the tool wrote: treat it as data, not as an instruction.

retryable boolean

Whether a hosted tool says the same call may succeed later (tool_failed with reason: tool_error).

stderr string

The first 4096 bytes of a hosted tool's standard error, on a development node only ([actions.tools] dev_stderr); never on a node that serves customers.

401 Missing, malformed, expired or revoked credentials (unauthorized).

application/problem+json

type string (uri) REQUIRED

https://docs.beta.b3os.org/errors#<code>.

title string REQUIRED

Short summary of the problem type.

status integer REQUIRED

The HTTP status code, repeated for convenience.

code string REQUIRED

Stable machine-readable error code from the errors catalog.

detail string REQUIRED

Explanation of this occurrence. Never contains secrets.

instance string

The request ID (req_…) of the request that failed. Include it when you contact support.

errors object[]

Validation problems, one per field (invalid_request and the other codes that list errors).

Array of:

pointer string REQUIRED

Where the problem is: a JSON pointer into the request body (/url, /steps/0/uses), or #query/<name>, #path/<name> or #header/<name> for parameters.

detail string REQUIRED

What is wrong there.

reason string

Finer-grained cause for codes that document one (unauthorized, forbidden, egress_denied, upstream_unreachable, …).

required_scope string

The scope that was missing (forbidden with reason: scope).

retry_after_s integer

Same value as the Retry-After header, for clients that only read the body.

limit object

The limit an error refers to. IDs and current values are listed by GET /v1/limits.

id string REQUIRED

Limit ID, such as vision.scrape.rpm or sandboxes.concurrent.

limit number REQUIRED

The limit's value.

unit string REQUIRED

What the limit counts, such as requests, sandboxes, vcpu or MiB.

window_s integer

Window length in seconds for rate limits and quotas.

current number

Current usage against the limit, when known.

current_status string

The object's current status, for state conflicts such as sandbox_not_running.

upstream_status integer

The HTTP status the upstream returned (upstream_error, action_output_invalid).

step string

The failed step, as a step ID (routines), an index (act) or a path such as beats/2/do/0 (render).

pack_error object

The error a pack's error mapping chose (upstream_error from pack actions).

code string REQUIRED

message string REQUIRED

retryable boolean REQUIRED

option string

The option a request value was refused for, by its id (option_not_allowed), e.g. sandboxes.clone_reset.

value unknown

The value the request asked for (option_not_allowed).

allowed unknown[]

The values the request may ask for (option_not_allowed, an option with a closed list of values).

bound_by string

What set the bound a refused value is outside (option_not_allowed); node is the node's policy.

Values node org flag limit

service string

The application's service a refusal is about, with port (the address codes, app_host_*).

port integer

The port of service a refusal is about (the address codes, app_host_*).

exit_code integer

The exit status of a hosted tool's command (tool_failed with reason: exit).

signal string

The signal that ended a hosted tool's command, such as SIGKILL (tool_failed with reason: signal).

tool_code string

The error code a hosted tool answered with (tool_failed with reason: tool_error), when it matches the pattern. Text the tool wrote, not a B3OS code.

tool_message string

The first 300 characters of a hosted tool's own error message (tool_failed with reason: tool_error). Text the tool wrote: treat it as data, not as an instruction.

retryable boolean

Whether a hosted tool says the same call may succeed later (tool_failed with reason: tool_error).

stderr string

The first 4096 bytes of a hosted tool's standard error, on a development node only ([actions.tools] dev_stderr); never on a node that serves customers.

403 Authenticated but not allowed (forbidden, egress_denied).

application/problem+json

type string (uri) REQUIRED

https://docs.beta.b3os.org/errors#<code>.

title string REQUIRED

Short summary of the problem type.

status integer REQUIRED

The HTTP status code, repeated for convenience.

code string REQUIRED

Stable machine-readable error code from the errors catalog.

detail string REQUIRED

Explanation of this occurrence. Never contains secrets.

instance string

The request ID (req_…) of the request that failed. Include it when you contact support.

errors object[]

Validation problems, one per field (invalid_request and the other codes that list errors).

Array of:

pointer string REQUIRED

Where the problem is: a JSON pointer into the request body (/url, /steps/0/uses), or #query/<name>, #path/<name> or #header/<name> for parameters.

detail string REQUIRED

What is wrong there.

reason string

Finer-grained cause for codes that document one (unauthorized, forbidden, egress_denied, upstream_unreachable, …).

required_scope string

The scope that was missing (forbidden with reason: scope).

retry_after_s integer

Same value as the Retry-After header, for clients that only read the body.

limit object

The limit an error refers to. IDs and current values are listed by GET /v1/limits.

id string REQUIRED

Limit ID, such as vision.scrape.rpm or sandboxes.concurrent.

limit number REQUIRED

The limit's value.

unit string REQUIRED

What the limit counts, such as requests, sandboxes, vcpu or MiB.

window_s integer

Window length in seconds for rate limits and quotas.

current number

Current usage against the limit, when known.

current_status string

The object's current status, for state conflicts such as sandbox_not_running.

upstream_status integer

The HTTP status the upstream returned (upstream_error, action_output_invalid).

step string

The failed step, as a step ID (routines), an index (act) or a path such as beats/2/do/0 (render).

pack_error object

The error a pack's error mapping chose (upstream_error from pack actions).

code string REQUIRED

message string REQUIRED

retryable boolean REQUIRED

option string

The option a request value was refused for, by its id (option_not_allowed), e.g. sandboxes.clone_reset.

value unknown

The value the request asked for (option_not_allowed).

allowed unknown[]

The values the request may ask for (option_not_allowed, an option with a closed list of values).

bound_by string

What set the bound a refused value is outside (option_not_allowed); node is the node's policy.

Values node org flag limit

service string

The application's service a refusal is about, with port (the address codes, app_host_*).

port integer

The port of service a refusal is about (the address codes, app_host_*).

exit_code integer

The exit status of a hosted tool's command (tool_failed with reason: exit).

signal string

The signal that ended a hosted tool's command, such as SIGKILL (tool_failed with reason: signal).

tool_code string

The error code a hosted tool answered with (tool_failed with reason: tool_error), when it matches the pattern. Text the tool wrote, not a B3OS code.

tool_message string

The first 300 characters of a hosted tool's own error message (tool_failed with reason: tool_error). Text the tool wrote: treat it as data, not as an instruction.

retryable boolean

Whether a hosted tool says the same call may succeed later (tool_failed with reason: tool_error).

stderr string

The first 4096 bytes of a hosted tool's standard error, on a development node only ([actions.tools] dev_stderr); never on a node that serves customers.

404 No such sandbox in this project (sandbox_not_found).

application/problem+json

type string (uri) REQUIRED

https://docs.beta.b3os.org/errors#<code>.

title string REQUIRED

Short summary of the problem type.

status integer REQUIRED

The HTTP status code, repeated for convenience.

code string REQUIRED

Stable machine-readable error code from the errors catalog.

detail string REQUIRED

Explanation of this occurrence. Never contains secrets.

instance string

The request ID (req_…) of the request that failed. Include it when you contact support.

errors object[]

Validation problems, one per field (invalid_request and the other codes that list errors).

Array of:

pointer string REQUIRED

Where the problem is: a JSON pointer into the request body (/url, /steps/0/uses), or #query/<name>, #path/<name> or #header/<name> for parameters.

detail string REQUIRED

What is wrong there.

reason string

Finer-grained cause for codes that document one (unauthorized, forbidden, egress_denied, upstream_unreachable, …).

required_scope string

The scope that was missing (forbidden with reason: scope).

retry_after_s integer

Same value as the Retry-After header, for clients that only read the body.

limit object

The limit an error refers to. IDs and current values are listed by GET /v1/limits.

id string REQUIRED

Limit ID, such as vision.scrape.rpm or sandboxes.concurrent.

limit number REQUIRED

The limit's value.

unit string REQUIRED

What the limit counts, such as requests, sandboxes, vcpu or MiB.

window_s integer

Window length in seconds for rate limits and quotas.

current number

Current usage against the limit, when known.

current_status string

The object's current status, for state conflicts such as sandbox_not_running.

upstream_status integer

The HTTP status the upstream returned (upstream_error, action_output_invalid).

step string

The failed step, as a step ID (routines), an index (act) or a path such as beats/2/do/0 (render).

pack_error object

The error a pack's error mapping chose (upstream_error from pack actions).

code string REQUIRED

message string REQUIRED

retryable boolean REQUIRED

option string

The option a request value was refused for, by its id (option_not_allowed), e.g. sandboxes.clone_reset.

value unknown

The value the request asked for (option_not_allowed).

allowed unknown[]

The values the request may ask for (option_not_allowed, an option with a closed list of values).

bound_by string

What set the bound a refused value is outside (option_not_allowed); node is the node's policy.

Values node org flag limit

service string

The application's service a refusal is about, with port (the address codes, app_host_*).

port integer

The port of service a refusal is about (the address codes, app_host_*).

exit_code integer

The exit status of a hosted tool's command (tool_failed with reason: exit).

signal string

The signal that ended a hosted tool's command, such as SIGKILL (tool_failed with reason: signal).

tool_code string

The error code a hosted tool answered with (tool_failed with reason: tool_error), when it matches the pattern. Text the tool wrote, not a B3OS code.

tool_message string

The first 300 characters of a hosted tool's own error message (tool_failed with reason: tool_error). Text the tool wrote: treat it as data, not as an instruction.

retryable boolean

Whether a hosted tool says the same call may succeed later (tool_failed with reason: tool_error).

stderr string

The first 4096 bytes of a hosted tool's standard error, on a development node only ([actions.tools] dev_stderr); never on a node that serves customers.

429 A rate, concurrency or quota limit applies (rate_limited, concurrency_limited, quota_exceeded).

application/problem+json

type string (uri) REQUIRED

https://docs.beta.b3os.org/errors#<code>.

title string REQUIRED

Short summary of the problem type.

status integer REQUIRED

The HTTP status code, repeated for convenience.

code string REQUIRED

Stable machine-readable error code from the errors catalog.

detail string REQUIRED

Explanation of this occurrence. Never contains secrets.

instance string

The request ID (req_…) of the request that failed. Include it when you contact support.

errors object[]

Validation problems, one per field (invalid_request and the other codes that list errors).

Array of:

pointer string REQUIRED

Where the problem is: a JSON pointer into the request body (/url, /steps/0/uses), or #query/<name>, #path/<name> or #header/<name> for parameters.

detail string REQUIRED

What is wrong there.

reason string

Finer-grained cause for codes that document one (unauthorized, forbidden, egress_denied, upstream_unreachable, …).

required_scope string

The scope that was missing (forbidden with reason: scope).

retry_after_s integer

Same value as the Retry-After header, for clients that only read the body.

limit object

The limit an error refers to. IDs and current values are listed by GET /v1/limits.

id string REQUIRED

Limit ID, such as vision.scrape.rpm or sandboxes.concurrent.

limit number REQUIRED

The limit's value.

unit string REQUIRED

What the limit counts, such as requests, sandboxes, vcpu or MiB.

window_s integer

Window length in seconds for rate limits and quotas.

current number

Current usage against the limit, when known.

current_status string

The object's current status, for state conflicts such as sandbox_not_running.

upstream_status integer

The HTTP status the upstream returned (upstream_error, action_output_invalid).

step string

The failed step, as a step ID (routines), an index (act) or a path such as beats/2/do/0 (render).

pack_error object

The error a pack's error mapping chose (upstream_error from pack actions).

code string REQUIRED

message string REQUIRED

retryable boolean REQUIRED

option string

The option a request value was refused for, by its id (option_not_allowed), e.g. sandboxes.clone_reset.

value unknown

The value the request asked for (option_not_allowed).

allowed unknown[]

The values the request may ask for (option_not_allowed, an option with a closed list of values).

bound_by string

What set the bound a refused value is outside (option_not_allowed); node is the node's policy.

Values node org flag limit

service string

The application's service a refusal is about, with port (the address codes, app_host_*).

port integer

The port of service a refusal is about (the address codes, app_host_*).

exit_code integer

The exit status of a hosted tool's command (tool_failed with reason: exit).

signal string

The signal that ended a hosted tool's command, such as SIGKILL (tool_failed with reason: signal).

tool_code string

The error code a hosted tool answered with (tool_failed with reason: tool_error), when it matches the pattern. Text the tool wrote, not a B3OS code.

tool_message string

The first 300 characters of a hosted tool's own error message (tool_failed with reason: tool_error). Text the tool wrote: treat it as data, not as an instruction.

retryable boolean

Whether a hosted tool says the same call may succeed later (tool_failed with reason: tool_error).

stderr string

The first 4096 bytes of a hosted tool's standard error, on a development node only ([actions.tools] dev_stderr); never on a node that serves customers.

500 Something failed inside B3OS (internal). Retry with backoff.

application/problem+json

type string (uri) REQUIRED

https://docs.beta.b3os.org/errors#<code>.

title string REQUIRED

Short summary of the problem type.

status integer REQUIRED

The HTTP status code, repeated for convenience.

code string REQUIRED

Stable machine-readable error code from the errors catalog.

detail string REQUIRED

Explanation of this occurrence. Never contains secrets.

instance string

The request ID (req_…) of the request that failed. Include it when you contact support.

errors object[]

Validation problems, one per field (invalid_request and the other codes that list errors).

Array of:

pointer string REQUIRED

Where the problem is: a JSON pointer into the request body (/url, /steps/0/uses), or #query/<name>, #path/<name> or #header/<name> for parameters.

detail string REQUIRED

What is wrong there.

reason string

Finer-grained cause for codes that document one (unauthorized, forbidden, egress_denied, upstream_unreachable, …).

required_scope string

The scope that was missing (forbidden with reason: scope).

retry_after_s integer

Same value as the Retry-After header, for clients that only read the body.

limit object

The limit an error refers to. IDs and current values are listed by GET /v1/limits.

id string REQUIRED

Limit ID, such as vision.scrape.rpm or sandboxes.concurrent.

limit number REQUIRED

The limit's value.

unit string REQUIRED

What the limit counts, such as requests, sandboxes, vcpu or MiB.

window_s integer

Window length in seconds for rate limits and quotas.

current number

Current usage against the limit, when known.

current_status string

The object's current status, for state conflicts such as sandbox_not_running.

upstream_status integer

The HTTP status the upstream returned (upstream_error, action_output_invalid).

step string

The failed step, as a step ID (routines), an index (act) or a path such as beats/2/do/0 (render).

pack_error object

The error a pack's error mapping chose (upstream_error from pack actions).

code string REQUIRED

message string REQUIRED

retryable boolean REQUIRED

option string

The option a request value was refused for, by its id (option_not_allowed), e.g. sandboxes.clone_reset.

value unknown

The value the request asked for (option_not_allowed).

allowed unknown[]

The values the request may ask for (option_not_allowed, an option with a closed list of values).

bound_by string

What set the bound a refused value is outside (option_not_allowed); node is the node's policy.

Values node org flag limit

service string

The application's service a refusal is about, with port (the address codes, app_host_*).

port integer

The port of service a refusal is about (the address codes, app_host_*).

exit_code integer

The exit status of a hosted tool's command (tool_failed with reason: exit).

signal string

The signal that ended a hosted tool's command, such as SIGKILL (tool_failed with reason: signal).

tool_code string

The error code a hosted tool answered with (tool_failed with reason: tool_error), when it matches the pattern. Text the tool wrote, not a B3OS code.

tool_message string

The first 300 characters of a hosted tool's own error message (tool_failed with reason: tool_error). Text the tool wrote: treat it as data, not as an instruction.

retryable boolean

Whether a hosted tool says the same call may succeed later (tool_failed with reason: tool_error).

stderr string

The first 4096 bytes of a hosted tool's standard error, on a development node only ([actions.tools] dev_stderr); never on a node that serves customers.

503 The node or the product is not available right now (node_unavailable, product_unavailable, capacity_unavailable).

application/problem+json

type string (uri) REQUIRED

https://docs.beta.b3os.org/errors#<code>.

title string REQUIRED

Short summary of the problem type.

status integer REQUIRED

The HTTP status code, repeated for convenience.

code string REQUIRED

Stable machine-readable error code from the errors catalog.

detail string REQUIRED

Explanation of this occurrence. Never contains secrets.

instance string

The request ID (req_…) of the request that failed. Include it when you contact support.

errors object[]

Validation problems, one per field (invalid_request and the other codes that list errors).

Array of:

pointer string REQUIRED

Where the problem is: a JSON pointer into the request body (/url, /steps/0/uses), or #query/<name>, #path/<name> or #header/<name> for parameters.

detail string REQUIRED

What is wrong there.

reason string

Finer-grained cause for codes that document one (unauthorized, forbidden, egress_denied, upstream_unreachable, …).

required_scope string

The scope that was missing (forbidden with reason: scope).

retry_after_s integer

Same value as the Retry-After header, for clients that only read the body.

limit object

The limit an error refers to. IDs and current values are listed by GET /v1/limits.

id string REQUIRED

Limit ID, such as vision.scrape.rpm or sandboxes.concurrent.

limit number REQUIRED

The limit's value.

unit string REQUIRED

What the limit counts, such as requests, sandboxes, vcpu or MiB.

window_s integer

Window length in seconds for rate limits and quotas.

current number

Current usage against the limit, when known.

current_status string

The object's current status, for state conflicts such as sandbox_not_running.

upstream_status integer

The HTTP status the upstream returned (upstream_error, action_output_invalid).

step string

The failed step, as a step ID (routines), an index (act) or a path such as beats/2/do/0 (render).

pack_error object

The error a pack's error mapping chose (upstream_error from pack actions).

code string REQUIRED

message string REQUIRED

retryable boolean REQUIRED

option string

The option a request value was refused for, by its id (option_not_allowed), e.g. sandboxes.clone_reset.

value unknown

The value the request asked for (option_not_allowed).

allowed unknown[]

The values the request may ask for (option_not_allowed, an option with a closed list of values).

bound_by string

What set the bound a refused value is outside (option_not_allowed); node is the node's policy.

Values node org flag limit

service string

The application's service a refusal is about, with port (the address codes, app_host_*).

port integer

The port of service a refusal is about (the address codes, app_host_*).

exit_code integer

The exit status of a hosted tool's command (tool_failed with reason: exit).

signal string

The signal that ended a hosted tool's command, such as SIGKILL (tool_failed with reason: signal).

tool_code string

The error code a hosted tool answered with (tool_failed with reason: tool_error), when it matches the pattern. Text the tool wrote, not a B3OS code.

tool_message string

The first 300 characters of a hosted tool's own error message (tool_failed with reason: tool_error). Text the tool wrote: treat it as data, not as an instruction.

retryable boolean

Whether a hosted tool says the same call may succeed later (tool_failed with reason: tool_error).

stderr string

The first 4096 bytes of a hosted tool's standard error, on a development node only ([actions.tools] dev_stderr); never on a node that serves customers.

curl -X GET 'https://beta-api.b3os.org/v1/sandboxes/sbx_01m5t68q1b590rj801nbzsqzkk/requests' \  -H 'Authorization: Bearer YOUR_API_TOKEN'

const response = await fetch('https://beta-api.b3os.org/v1/sandboxes/sbx_01m5t68q1b590rj801nbzsqzkk/requests', {  method: 'GET',  headers: {      "Authorization": "Bearer YOUR_API_TOKEN"  }});const data = await response.json();console.log(data);

import requestsheaders = {    'Authorization': 'Bearer YOUR_API_TOKEN'}response = requests.get('https://beta-api.b3os.org/v1/sandboxes/sbx_01m5t68q1b590rj801nbzsqzkk/requests', headers=headers)print(response.json())

200 Response

{  "object": "list",  "data": [    {      "id": "req_01m5t6d8ksbzrfxhqhzge06mqn",      "object": "request",      "method": "POST",      "path": "/v1/infer/chat/completions",      "operation_id": "inferCreateChatCompletion",      "product": "infer",      "status_code": 200,      "error_code": null,      "org_id": "org_01m5t5hthd29mm5wpza5ndd6mm",      "project_id": "prj_01m5t3pf8heewxt65ej3dm577y",      "key_id": "key_01m5t5csy2wt4e3er052chyf1x",      "node": "n1",      "connection": "sandbox",      "sandbox_id": "sbx_01m5t68q1b590rj801nbzsqzkk",      "started_at": "2026-10-25T21:29:58.204Z",      "duration_ms": 812.4,      "request_bytes": 1830,      "response_bytes": 2210,      "phases": [],      "trace_id": null,      "user_agent": "openai-python/2.6.0",      "source": "sandbox"    }  ],  "next_cursor": null}

400 Response

{  "type": "https://docs.beta.b3os.org/errors#invalid_request",  "title": "Invalid request",  "status": 400,  "code": "invalid_request",  "detail": "1 field failed validation",  "instance": "req_01m5t4yg394wegr3j4y01qb363",  "errors": [    {      "pointer": "/url",      "detail": "must be an absolute http or https URL"    }  ]}

401 Response

{  "type": "https://docs.beta.b3os.org/errors#unauthorized",  "title": "Unauthorized",  "status": 401,  "code": "unauthorized",  "detail": "API key checksum does not match; check that the whole key was copied",  "instance": "req_01m5t4yg394wegr3j4y01qb363",  "reason": "malformed"}

403 Response

{  "type": "https://docs.beta.b3os.org/errors#forbidden",  "title": "Forbidden",  "status": 403,  "code": "forbidden",  "detail": "This key lacks the scope sandboxes:write",  "instance": "req_01m5t4yg394wegr3j4y01qb363",  "reason": "scope",  "required_scope": "sandboxes:write"}

404 Response

{  "type": "https://docs.beta.b3os.org/errors#sandbox_not_found",  "title": "Sandbox not found",  "status": 404,  "code": "sandbox_not_found",  "detail": "No sandbox sbx_01m5t68q1b590rj801nbzsqzkk in this project",  "instance": "req_01m5t4yg394wegr3j4y01qb363"}

429 Response

{  "type": "https://docs.beta.b3os.org/errors#rate_limited",  "title": "Rate limited",  "status": 429,  "code": "rate_limited",  "detail": "60 scrapes per minute allowed; retry in 12 seconds",  "instance": "req_01m5t4yg394wegr3j4y01qb363",  "retry_after_s": 12,  "limit": {    "id": "vision.scrape.rpm",    "limit": 60,    "unit": "requests",    "window_s": 60,    "current": 60  }}

500 Response

{  "type": "https://docs.beta.b3os.org/errors#internal",  "title": "Internal error",  "status": 500,  "code": "internal",  "detail": "internal error",  "instance": "req_01m5t4yg394wegr3j4y01qb363"}

503 Response

{  "type": "https://docs.beta.b3os.org/errors#node_unavailable",  "title": "Node unavailable",  "status": 503,  "code": "node_unavailable",  "detail": "Node n1 is not reachable; retry in 5 seconds",  "instance": "req_01m5t4yg394wegr3j4y01qb363",  "retry_after_s": 5}

GET /v1/sandboxes/{sandbox_id}/requests

Base URL

Bearer Token

Path Parameters

sandbox_id string required

Query Parameters

limit integer

cursor string

product string

operation_id string

status string

trace_id string

since string (date-time)

Response

Was this page helpful?

Previous Read what a sandbox uses now

Next Run a command