rollouts

Fork children from a state

Fork children from a state: N rollouts continuing from the same content-addressed parent, in the parent's environment, with per-child spec patches and seeds. Sandbox kind forks the snapshot (pinned to its host; a cold parent quotes its restore and needs confirm). Task kind appends to the parent's live pool preferring the machine that holds the state, or starts a pool when the parent's is gone. group: true attests the set.

post/preview/rollouts/states/{st}/fork

Request

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

Path parameters

ststring required

The parent state (st-...).

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

branchesinteger nullable

How many children (default 1; the fan-out limit bounds the total across calls).

chipstring nullable

Task kind, when a new pool is needed: the runner's chip, count, env.

confirmboolean nullable

Accept the quoted restore cost for a cold fork.

envobject
evaluationstring nullable
groupboolean nullable

Attest the children as a group.

labelsunknown
memoboolean nullable
missionstring nullable
runnersinteger nullable
seedsunknown

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.