/ideas
ideas:create, ideas:write (eski uyumluluk)
Header'lar
Authorization
*API key. Format: Bearer xpl_live_...
Idempotency-Key
*Unique value of 1-255 characters to safely retry the same write request.
Content-Type
Use application/json when sending JSON body.
Body
accountId
*The XPlanner account id to which the idea will be linked. It is taken from the id field in the GET /accounts response.
content
*Fikir metni. En fazla 5000 karakter.
title
Optional title. Maximum 160 characters.
folderId
Folder id belonging to the same account. If left blank, the idea will be created without a folder.
isPinned
If true is sent, the idea is created as pinned. If not sent, it is considered false.
mediaAssetIds
Optional XPlanner media library asset ids. It must belong to the same account and workspace.
Media rules
mediaAssetIds
XPlanner accepts asset ids from the media library. Each media must belong to the same account and workspace.
görsel
A maximum of 10 images can be linked to the idea card.
GIF
Up to 4 GIFs can be linked to the idea card.
response
The idea generation answer does not return the linked media list. The media is stored attached to the idea card.
Cevaplar
The idea was created.
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"}