/folders
folders:create
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
socialSetId
*Klasörün bağlanacağı Sosyal Set kimliği.
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ı Sosyal Set'teki 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 '{ "socialSetId": "set_123", "name": "Lansman fikirleri", "color": "blue", "isPinned": true }'Cevap
{ "data": { "id": "fld_123", "socialSetId": "set_123", "name": "Lansman fikirleri", "color": "blue", "isPinned": true, "order": 0, "workspaceId": "wrk_123", "createdAt": "2026-05-15T09:00:00.000Z", "updatedAt": "2026-05-15T09:00:00.000Z" }, "requestId": "req_123"}