Skip to main content
GET
/
threads
/
{id}
Get thread
curl --request GET \
  --url https://app.usechar.ai/api/threads/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "organization_id": "<string>",
  "end_user_id": "<string>",
  "title": "<string>",
  "status": "regular",
  "message_count": 0,
  "total_tokens": 0,
  "created_at": "2023-11-07T05:31:56Z",
  "last_message_at": "2023-11-07T05:31:56Z",
  "resolved_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

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.