List Threads Handler - Knowledge Stack

GET

threads

List Threads Handler

curl --request GET \
  --url http://localhost:8000/v1/threads

{
  "items": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "path_part_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "materialized_path": "<string>",
      "tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "parent_thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "total": 1,
  "limit": 2,
  "offset": 1
}

Headers

authorization

string | null

Query Parameters

parent_path_part_id

string<uuid> | null

Parent PathPart ID. Omit to list user's conversation threads.

limit

integer

default:20

Number of items per page

Required range: 1 <= x <= 100

offset

integer

default:0

Number of items to skip

Required range: x >= 0

Cookies

ks_uat

string | null

Response

Successful Response

items

ThreadResponse · object[]

required

List of items

Show child attributes

total

integer

required

Total number of items

Required range: x >= 0

limit

integer

required

Number of items per page

Required range: x >= 1

offset

integer

required

Number of items to skip

Required range: x >= 0

Create Thread HandlerCreate a new thread. If parent_path_part_id is omitted, the thread is created under the user's /users/{user_id}/threads/ folder (auto-provisioned if needed).

List Threads Handler

curl --request GET \
  --url http://localhost:8000/v1/threads

{
  "items": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "path_part_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "materialized_path": "<string>",
      "tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "parent_thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "total": 1,
  "limit": 2,
  "offset": 1
}