GET
/folders
folders:read
Header'lar
Authorization
*string
API key. Format: Bearer xpl_live_...
Query parametreleri
accountId
string
Narrows the results to a single XPlanner account ID.
query
string
Search by folder name. Maximum 120 characters.
limit
integer
Number of records per page. Default is 50, maximum is 100.
cursor
string
The pagination.nextCursor value from the previous answer.
Listing behavior
accountId
opsiyonel
If given, the results will be reduced to a single account. If not given, folders in all accessible accounts are returned.
query
contains
It performs a case-insensitive search in the folder name. A maximum of 120 characters is accepted.
sıralama
createdAt desc
Results are sorted by creation date, newest to oldest.
The folder list uses cursor pagination and narrows the results based on the reach of the API key.
Cevaplar
200
Paged folder list.
404
accountId not found or key not accessible.
cURL
curl "https://api.xplanner.co/v1/folders?accountId=acc_123&query=lansman&limit=10" \ -H "Authorization: Bearer $XPLANNER_API_KEY"Cevap
{ "data": [ { "id": "fld_123", "accountId": "acc_123", "name": "Lansman fikirleri", "color": "blue", "isPinned": true, "order": 0, "workspaceId": "wrk_123", "xUserId": "123456789", "createdAt": "2026-05-15T09:00:00.000Z", "updatedAt": "2026-05-15T09:00:00.000Z" } ], "pagination": { "nextCursor": null }, "requestId": "req_123"}