Read sandbox CPU, memory, and GPU usage for a session tree
Returns the tree’s sandbox attachments and one page of per-minute resource usage buckets for them, ordered by attachment then time. Each bucket carries the minute’s average and peak; resolution=raw adds the individual samples as parallel arrays indexed by offsets_ms. A tree whose compute was released and revived has several attachments; follow revived_from_sandbox_id to connect them. live reports whether a sandbox is still attached, which is the cue to keep polling. An empty sandboxes list means the tree never ran in a sandbox or sampling is disabled; an attachment with sampling_source=unsupported means the sandbox could not measure itself.
Authorizations
A Recursion API key, created in the console under API keys.
Path Parameters
Any session id (UUID) in the tree. The sandbox is shared by the whole tree, so every id in it returns the same usage.
Query Parameters
Inclusive lower bound on bucket_start, RFC 3339. Omit for the start of the tree.
Exclusive upper bound on bucket_start, RFC 3339. Omit for now.
minute returns per-minute summaries only; raw also includes each bucket's per-sample arrays at the producer's cadence (five seconds by default). Use raw for the window on screen and minute for the overview.
minute, raw Maximum buckets per page, across all of the tree's sandbox attachments.
1 <= x <= 720Signed continuation token from a previous page's next_page_token. Bound to the organization, session, and filters it was issued for.
Response
Sandbox CPU, memory, and accelerator usage for a session tree, as minute buckets per sandbox attachment. Samples are what the sandbox measured of itself, collected on tool calls and on read.
Sandbox CPU, memory, and accelerator usage for a session tree, as minute buckets per sandbox attachment. Samples are what the sandbox measured of itself, collected on tool calls and on read.
RFC 3339 server time at which the page was read.
One page of minute buckets ordered by (sandbox_id, bucket_start). Each bucket names its attachment; join on sandboxes to place it on a lane.
True while a sandbox that can be sampled is still attached to the tree. A client keeps polling while this is true and stops once it turns false; an attached sandbox that cannot measure itself does not keep it true.
Resolution the buckets were read at.
minute, raw Root of the tree the usage belongs to.
Every sandbox attachment the tree has had, oldest first, including ones that have since been released or closed. Empty when the tree never had a sandbox or sampling is disabled. Complete on every page.
Session id named in the request.
Present when more buckets remain. Pass as page_token with the same query to continue.