/folders
folders:create, folders:write (eski uyumluluk)
Header'lar
Authorization
*API anahtarı. Format: Bearer xpl_live_...
Idempotency-Key
*Aynı yazma isteğinin güvenle tekrar denenmesi için 1-255 karakterlik benzersiz değer.
Content-Type
JSON body gönderirken application/json kullan.
Body
accountId
*Klasörün bağlanacağı XPlanner hesap id'si.
name
*Klasör adı. En fazla 120 karakter.
color
blue, green, lime, yellow, orange, red, purple, black veya gray. Varsayılan blue.
order
Sıralama değeri. Sıfır veya daha büyük tam sayı.
isPinned
Klasörü sabitlenmiş oluşturur.
Klasör davranışı
color
Geçerli değerler blue, green, lime, yellow, orange, red, purple, black ve gray.
order
Gönderilmezse klasör aynı hesaptaki mevcut klasörlerin sonuna eklenir.
isPinned
true gönderilirse klasör sabitlenmiş oluşturulur.
Cevaplar
Klasör oluşturuldu.
Idempotency-Key çakışması veya devam eden işlem.
cURL
curl -X POST https://api.xplanner.co/v1/folders \ -H "Authorization: Bearer $XPLANNER_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: folder-001" \ -d '{ "accountId": "acc_123", "name": "Lansman fikirleri", "color": "blue", "isPinned": true }'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" }, "requestId": "req_123"}