worktrees

Set User Session Worktree

Set the worktree for a user session.

patch/api/v1/worktrees/session/{session_id}

Path parameters

session_idstring required

Request body

worktree_idstring required

Worktree ID to associate with session

Response

Successful Response

idstring required

Unique worktree identifier

workspace_idstring required

Parent workspace identifier

namestring nullable

Worktree name (null for the main worktree)

is_mainboolean required

Whether this is the main/default worktree for the workspace

pathstring nullable

Filesystem path for the worktree on the machine

worktree_type'LOCAL' | 'REMOTE' nullable

Type of worktree: LOCAL (user machine) or REMOTE (sandbox)

managed_machine_idstring nullable

Managed machine ID if worktree_type is REMOTE

last_heartbeat_atstring date-time nullable

Most recent liveness heartbeat received from the sandbox container (REMOTE only).

last_synced_checkpoint_idstring nullable

ID of the last checkpoint that was successfully synced to cloud storage. This may differ from current_checkpoint_id if a recent checkpoint failed to sync.

checkpoint_restore_pendingboolean

Whether a checkpoint needs to be restored on next local session start

current_checkpoint_idstring nullable

Identifier of the current checkpoint for this worktree

checkpoint_metadataobject nullable

Metadata associated with the current checkpoint (e.g., commit info)

created_atstring date-time required

Timestamp when the worktree was created

updated_atstring date-time required

Timestamp when the worktree was last updated

Changes

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