Sign in
Threads

Update trace thread

Update a trace thread.

patch/v2/sessions/{session_id}

Path parameters

session_idstring required

Request body

external_idstring
durationnumber double
contact_idsstring[]
traces_countinteger
tagsstring[]
project_idstring
started_atstring date-time
updated_atstring date-time
clear_contact_idsboolean

Remove every contact id. Mutually exclusive with contact_ids.

clear_tagsboolean

Remove every tag. Mutually exclusive with tags.

titlestring
clientstring
repostring
kind'THREAD_KIND_UNSPECIFIED' | 'THREAD_KIND_CONVERSATION' | 'THREAD_KIND_CODING_AGENT'

Response

OK

_idstring required

Internal thread record ID.

external_idstring required

Client-provided thread identifier used to group related traces.

durationnumber double required

Total thread duration in milliseconds.

contact_idsstring[] required

Contact IDs associated with the thread.

traces_countinteger required

Number of traces associated with the thread.

tagsstring[] required

Tags used to categorize the thread.

project_idstring
started_atstring date-time
updated_atstring date-time
titlestring

Display title. Does not replace external_id and is not used to group traces.

clientstring

Originating coding assistant or client, such as claude-code, cursor, or codex.

repostring

Canonical git repository for a coding-agent thread, such as github.com/org/repo.

kind'THREAD_KIND_UNSPECIFIED' | 'THREAD_KIND_CONVERSATION' | 'THREAD_KIND_CODING_AGENT'

Changes

Changed in 3 of the 350 revisions of this API.12

Of the 350 revisions, 136 have no diff computed.