/ideas
ideas:create, ideas: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
*Fikrin bağlanacağı XPlanner hesap id'si. GET /accounts cevabındaki id alanından alınır.
content
*Fikir metni. En fazla 5000 karakter.
title
Opsiyonel başlık. En fazla 160 karakter.
folderId
Aynı hesaba ait klasör id'si. Boş bırakılırsa fikir klasörsüz oluşturulur.
isPinned
true gönderilirse fikir sabitlenmiş oluşturulur. Gönderilmezse false kabul edilir.
mediaAssetIds
Opsiyonel XPlanner medya kütüphanesi varlık id'leri. Aynı hesaba ve çalışma alanına ait olmalı.
Medya kuralları
mediaAssetIds
XPlanner medya kütüphanesindeki varlık id'lerini kabul eder. Her medya aynı hesaba ve çalışma alanına ait olmalı.
görsel
Fikir kartına en fazla 10 görsel bağlanabilir.
GIF
Fikir kartına en fazla 4 GIF bağlanabilir.
response
Fikir oluşturma cevabı bağlı medya listesini döndürmez. Medya, fikir kartına bağlanmış halde saklanır.
Cevaplar
Fikir oluşturuldu.
cURL
curl -X POST https://api.xplanner.co/v1/ideas \ -H "Authorization: Bearer $XPLANNER_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: idea-001" \ -d '{ "accountId": "acc_123", "folderId": "fld_123", "title": "API lansmanı", "content": "Public API ile içerik akışını dış araçlara aç.", "isPinned": true, "mediaAssetIds": ["media_123", "media_456"] }'Cevap
{ "data": { "id": "idea_123", "accountId": "acc_123", "folderId": "fld_123", "title": "API lansmanı", "content": "Public API ile içerik akışını dış araçlara aç.", "isPinned": true, "workspaceId": "wrk_123", "xUserId": "123456789", "createdAt": "2026-05-15T09:00:00.000Z", "updatedAt": "2026-05-15T09:00:00.000Z" }, "requestId": "req_123"}