INNER CODE UNIT · Python

branch_sandbox

deeplethe/forkd · sdk/mcp/sandstorm_mcp/server.py:216

def branch_sandbox(sandbox_id: str, tag: str) -> dict[str, Any]:
    """Checkpoint a running sandbox into a new snapshot tag.

    The parent keeps running, after a short pause. Any later spawn_sandboxes
    call can use the tag as its snapshot_tag, to fan out N children that all
    inherit the source's exact state at branch time.

    This is sandstorm's core primitive.

    Args:
        sandbox_id: Id of the source sandbox (see list_sandboxes). It must be
            hot; touch_sandbox wakes it.
        tag: Name for the new snapshot: no slashes, no leading dots.

    Returns a Snapshot: tag, node_id, template, from_sandbox, dir,
    size_bytes, created_at.
    """
    with _client(timeout=BRANCH_TIMEOUT) as c:

View source record →