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. |
| ↳created_at string · date-time | |
| next_cursor string · nullable | |
| has_more boolean |