XPlanner

Docs

Update idea

Updates the idea title, content, folder, pin status, or linked media.


PATCH

/ideas/{id}

ideas:update, ideas:write (eski uyumluluk)

Header'lar

Authorization

*
string

API key. Format: Bearer xpl_live_...

Idempotency-Key

*
string

Unique value of 1-255 characters to safely retry the same write request.

Content-Type

string

Use application/json when sending JSON body.

Body

title

string | null

Optional title. Maximum 160 characters.

content

string

Fikir metni. En fazla 5000 karakter.

folderId

string | null

New folder id or null to make it folderless.

isPinned

boolean

Pins or unpins the idea in the panel.

mediaAssetIds

string[]

Idea-related media asset ids.

Cevaplar

200

Idea updated.

404

No ideas or folders found.

cURL

curl -X PATCH https://api.xplanner.co/v1/ideas/idea_123 \  -H "Authorization: Bearer $XPLANNER_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: idea-update-001" \  -d '{    "title": "API lansmanı",    "content": "Public API + MCP genişlemesini duyuran kısa post fikri.",    "isPinned": true  }'

Cevap

{  "data": {    "id": "idea_123",    "accountId": "acc_123",    "folderId": "fld_123",    "title": "API lansmanı",    "content": "Public API + MCP genişlemesini duyuran kısa post fikri.",    "isPinned": true,    "workspaceId": "wrk_123",    "xUserId": "123456789",    "createdAt": "2026-05-15T09:00:00.000Z",    "updatedAt": "2026-05-15T10:00:00.000Z"  },  "requestId": "req_123"}