Skip to main content
GET
/
end-users
/
{end_user_id}
/
threads
List threads by end user
curl --request GET \
  --url https://app.usechar.ai/api/end-users/{end_user_id}/threads \
  --header 'Authorization: Bearer <token>'
{
  "threads": [
    {
      "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"
    }
  ],
  "total": 123
}

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

​
end_user_id
string<uuid>
required

End user ID to filter threads

Query Parameters

​
status
enum<string>

Filter by thread status (default: all)

Available options:
regular,
archived,
deleted
​
limit
integer

Maximum threads to return (default: 100)

Required range: 1 <= x <= 100
​
offset
integer

Number of items to skip for pagination

Required range: 0 <= x <= 9007199254740991

Response

OK

​
threads
object[]
required
​
total
number
required