PATCH
/folders/{id}
folders:update, folders:write (eski uyumluluk)
Header'lar
Authorization
*string
API anahtarı. Format: Bearer xpl_live_...
Idempotency-Key
*string
Aynı yazma isteğinin güvenle tekrar denenmesi için 1-255 karakterlik benzersiz değer.
Content-Type
string
JSON body gönderirken application/json kullan.
Body
name
string
Klasör adı. En fazla 120 karakter.
color
string
blue, green, lime, yellow, orange, red, purple, black veya gray.
order
integer
Sıralama değeri. Sıfır veya daha büyük tam sayı.
isPinned
boolean
Klasörü panelde sabitler veya sabitlemesini kaldırır.
Cevaplar
200
Klasör güncellendi.
404
Klasör bulunamadı veya erişim yok.
cURL
curl -X PATCH https://api.xplanner.co/v1/folders/fld_123 \ -H "Authorization: Bearer $XPLANNER_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: folder-update-001" \ -d '{ "name": "Lansman fikirleri", "color": "purple", "isPinned": true }'Cevap
{ "data": { "id": "fld_123", "accountId": "acc_123", "name": "Lansman fikirleri", "color": "purple", "isPinned": true, "order": 0, "workspaceId": "wrk_123", "xUserId": "123456789", "createdAt": "2026-05-15T09:00:00.000Z", "updatedAt": "2026-05-15T10:00:00.000Z" }, "requestId": "req_123"}