sandboxes

Capture a running sandbox as a new forkable snapshot [rate class: sandbox_api_rps]

Capture a running sandbox's CURRENT state - memory, processes, disk - as a new forkable snapshot, without stopping the sandbox. This is how a computed prefix gets shared instead of recomputed: run the common steps once in one sandbox, snapshot_sandbox, then fork_sandbox that snapshot so every branch starts from the finished work. Use it at branch points (explore K continuations of one trajectory), before risky steps (retry from the checkpoint instead of from scratch), and to compare approaches from a truly identical starting state. Snapshots are content-addressed against their parent, so capturing one is cheap and far faster than re-running the steps it contains.

post/preview/sandboxes/{id}/snapshot

Request

  • Base URL: https://autoresearch.sfcompute.com
  • URL: https://autoresearch.sfcompute.com/preview/sandboxes/{id}/snapshot
  • Auth: HTTP bearer

Path parameters

idstring required

The running sandbox whose current state to capture.

Query parameters

workspacestring

Act in this workspace (its slug). Omitted: the token's bound workspace, then the organization's default. Never ambient - there is no switch-workspace mutation on this door.

Request body

expires_afterstring nullable

Self-cleaning expiry for the captured snapshot: a duration from now ("24h", "7d"; minimum 1h), or "never". The default is forever; snapshots never expire unless YOU schedule it (set_sandbox_snapshot_expiry changes it later).

Response

The capability's JSON result.

objectstring

The resource type, when the result is one resource.

Changes

No recorded changes to this operation across all 1 revision of this API.