user_sessions

Update User Session

Update a user session (e.g., rename).

Returns 404 if the session is not found or has been deleted.

patch/api/v1/user-sessions/{user_session_id}

Path parameters

user_session_idstring required

namestring nullable

New name for the session

Successful Response

kind'user_session'

Descriptor type discriminator

session_idstring uuid required

Unique session identifier

user_idstring uuid required

Owner user identifier

status'ACTIVE' | 'COMPLETED' | 'DELETED' required

created_atstring date-time required

Timestamp when the session was created

namestring nullable

Optional user-defined session name

metadataobject nullable

Arbitrary session metadata

worktree_idstring uuid nullable

Associated worktree identifier

worktree_namestring nullable

Name of the associated worktree

worktree_type'LOCAL' | 'REMOTE'

Whether a worktree runs on a user's local machine or a managed remote machine.

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