/ideas
ideas:create
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
socialSetId
*Social Set id that owns the idea. Read it from the id field returned by GET /social-sets.
content
*Fikir metni. En fazla 5000 karakter.
title
Optional title. Maximum 160 characters.
folderId
Folder id from the same Social Set. Leave empty to create an unfiled idea.
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. They must belong to the same Social Set and workspace.
Media rules
mediaAssetIds
Accepts asset ids from the XPlanner media library. Every asset must belong to the same Social Set 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 '{ "socialSetId": "set_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", "socialSetId": "set_123", "folderId": "fld_123", "title": "API lansmanı", "content": "Public API ile içerik akışını dış araçlara aç.", "isPinned": true, "themeColor": "blue", "archivedAt": null, "workspaceId": "wrk_123", "createdAt": "2026-05-15T09:00:00.000Z", "updatedAt": "2026-05-15T09:00:00.000Z" }, "requestId": "req_123"}