API v1 ReferenceAgent Threads

Returns thread metadata for usage analytics.

Returns thread metadata for usage analytics, including the thread Id, name, credits, and creation timestamp. <Check title="Required Permissions" icon="key">The user must be an admin.</Check>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Response

OK
idstringOptionalformat: "uuid"
The thread identifier.
typestring or nullOptional
The thread type.
titlestring or nullOptional

The contextual thread title. A private thread title is available only to its creator. Contributors do not widen this: they exist only on project- or task-backed threads, whose titles are never masked.

createdBystringOptionalformat: "uuid"
The human creator identifier.
agentIdstring or nullOptionalformat: "uuid"
The associated Agent identifier.
agentNameSnapshotstring or nullOptional
The Agent display name captured for the initial run.
executionTypestring or nullOptional

The initial execution trigger type: direct, task-assignment, project-assignment, mention, schedule, automation, queue, delegation, or workflow.

projectIdstring or nullOptionalformat: "uuid"
The project context identifier.
taskIdstring or nullOptionalformat: "uuid"
The task context identifier.
clientIdstring or nullOptionalformat: "uuid"
The client context identifier.
statusstring or nullOptional
The current thread status.
creditsUsedlongOptional
The whole credits attributed to this thread for workspace administration. This display value is independent from aggregate quota accounting.
createdOnstring or nullOptionalformat: "date-time"
When the thread was created.
lastActivityOnstring or nullOptionalformat: "date-time"

When the thread last had user-visible activity.

updatedOnstring or nullOptionalformat: "date-time"
When the thread was last updated.