Skip to main content
GET
Get thread

Authorizations

Authorization
string
header
required

WorkOS JWT token. Obtain via WorkOS AuthKit authentication flow. The token must include organization_id claim for organization-scoped endpoints.

Path Parameters

id
string<uuid>
required

Unique identifier (UUID) of the resource

Response

OK

Thread resource representing a conversation thread. Used for analytics queries across threads.

id
string
required

Thread ID (matches the ThreadAgent Durable Object name).

organization_id
string
required

WorkOS organization ID that owns the thread.

end_user_id
string
required

Internal end user ID associated with the thread.

title
string | null
required

Optional thread title.

status
enum<string>
required

Thread status (regular, archived, or deleted).

Available options:
regular,
archived,
deleted
message_count
integer
required

Total number of messages in the thread.

Required range: -9007199254740991 <= x <= 9007199254740991
total_tokens
integer
required

Total token usage accumulated for the thread.

Required range: -9007199254740991 <= x <= 9007199254740991
created_at
string<date-time>
required

Timestamp when the thread was created.

last_message_at
string<date-time> | null
required

Timestamp of the most recent message in the thread.

resolved_at
string<date-time> | null
required

Timestamp when the thread was resolved or closed, if applicable.

updated_at
string<date-time>
required

Timestamp when the thread record was last updated.