Sign in
Threads

Create trace thread

Create a thread for traces.

post/v2/sessions

Request body

external_idstring required
durationnumber double required
contact_idsstring[] required
traces_countinteger required
tagsstring[] required
project_idstring
started_atstring date-time
updated_atstring date-time
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.