rollouts

Snapshot a sandbox-kind rollout as a state

Declare a state for a SANDBOX-kind rollout: its bound sandbox is snapshotted (the guest pauses for the snapshot) and the snapshot becomes a state a fork can start from. A state per rollout is a snapshot per rollout on your bill; set expires_after.

post/preview/rollouts/{id}/states

Request

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

Path parameters

idstring required

A sandbox-kind rollout (ro-...): its bound sandbox is snapshotted.

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

"30d", "7d", "never". Default: the org's snapshot default, else never.

labelstring required

A caption (1-120 chars): "step-40".

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.