folders

List folders

Returns folders the API key's user can see in the workspace, ordered by created_at descending. Use the returned id as folder_id on GET /conversations to filter conversations to a folder subtree.

GET /api/v1/folders

Query parameters

limit integer	Page size (max 100).
cursor string	Cursor returned from a previous list response.
folder_id string	Restrict to folders inside this folder. By default any descendant is returned; pass `recursive=false` for direct children only.
recursive boolean	When `folder_id` is set, controls whether descendants are included. Default `true`; set `false` to limit to direct children of `folder_id`.

Response fields

data array of object
↳id string	Folder identifier.
↳name string
↳parent_id string · nullable	ID of the parent folder, or null for top-level folders.
↳shared boolean	Whether the folder is shared with the whole workspace.
↳created_at string · date-time
next_cursor string · nullable
has_more boolean

GET /api/v1/folders

curl https://app.klang.ai/api/v1/folders \
  -H "Authorization: Bearer sk_..."

import Klang from "@klang-ai/sdk-ts";

const client = new Klang();

const page = await client.folders.list({
  limit: 0,
  cursor: "string",
});

Response 200

{
  "data": [
    {
      "id": "23",
      "name": "Q2 prospects",
      "parent_id": "18",
      "created_at": "2026-03-10T14:30:00Z"
    },
    {
      "id": "18",
      "name": "Sales calls",
      "parent_id": null,
      "created_at": "2026-02-01T12:00:00Z"
    },
    {
      "id": "12",
      "name": "Customer interviews",
      "parent_id": null,
      "created_at": "2026-01-15T09:00:00Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}