Skip to main content
GET
/
v1
/
folders
/
search
Search Items Handler
curl --request GET \
  --url http://localhost:8000/v1/folders/search
{
  "items": [
    {
      "part_type": "FOLDER",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "path_part_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "parent_path_part_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "materialized_path": "<string>",
      "system_managed": true,
      "tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "tags": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "color": "<string>",
          "tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "created_at": "2023-11-07T05:31:56Z",
          "updated_at": "2023-11-07T05:31:56Z",
          "description": "<string>"
        }
      ]
    }
  ],
  "total": 1,
  "limit": 2,
  "offset": 1
}

Documentation Index

Fetch the complete documentation index at: https://docs.knowledgestack.ai/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
authorization
string | null

Query Parameters

​
name_like
string
required

Case-insensitive partial name search

Required string length: 1 - 255
​
sort_order
enum<string>
default:NAME

Sort order for results (default: NAME)

Available options:
NAME,
UPDATED_AT,
CREATED_AT
​
part_type
enum<string> | null

Filter by item type (default: both folders and documents)

Available options:
FOLDER,
DOCUMENT
​
with_tags
boolean
default:false

Include tags in the response (default: false)

​
parent_path_part_id
string<uuid> | null

Scope search to descendants of this folder's path part

​
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
(FolderResponse · object | DocumentResponse · object)[]
required

List of items

Folder response model.

​
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