GET
/folders
folders:read
Header'lar
Authorization
*string
API anahtarı. Format: Bearer xpl_live_...
Query parametreleri
accountId
string
Sonuçları tek XPlanner hesap id'sine daraltır.
query
string
Klasör adına göre arama. En fazla 120 karakter.
limit
integer
Sayfa başına kayıt sayısı. Varsayılan 50, maksimum 100.
cursor
string
Önceki cevaptaki pagination.nextCursor değeri.
Listeleme davranışı
accountId
opsiyonel
Verilirse sonuçlar tek hesaba iner. Verilmezse erişilebilen tüm hesaplardaki klasörler döner.
query
contains
Klasör adında büyük/küçük harfe duyarsız arama yapar. En fazla 120 karakter kabul edilir.
sıralama
createdAt desc
Sonuçlar oluşturulma tarihine göre yeniden eskiye sıralanır.
Klasör listesi cursor pagination kullanır ve sonuçları API anahtarının erişim alanına göre daraltır.
Cevaplar
200
Sayfalanmış klasör listesi.
404
accountId bulunamadı veya anahtarın erişimi yok.
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"}