Sign in

v1

latestOpenAPI 3.1.02026-07-175793186.0 KB
sessions

Patch session metadata

Update session title and/or metadata_json. Returns the updated session snapshot.

patch/api/v1/sessions/{session_id}

Path parameters

session_idstring required

Identifier of the session to update.

Identifier of the session to update.

Request body

titlestring nullable

New human-readable session title.

metadata_jsonobject nullable

New metadata dictionary to merge or replace session metadata.

Response

Successful Response

idstring required

Durable session identifier.

titlestring required

Human-readable session title.

statusstring required

Session status (active, archived).

model_namestring nullable

Model used in session.

external_session_idstring nullable

Canonical runtime session identifier.

workspace_idstring nullable

Workspace context.

turn_countinteger required

Total number of turns in this session.

created_atstring required

ISO-8601 creation timestamp.

updated_atstring required

ISO-8601 last-update timestamp.