GET
/ideas
ideas:read
Header'lar
Authorization
*string
API key. Format: Bearer xpl_live_...
Query parametreleri
accountId
string
Narrows the results to a single XPlanner account ID.
folderId
string | null
Specific folder id. For ideas without folders, send folderId=null.
limit
integer
Number of records per page. Default is 50, maximum is 100.
cursor
string
The pagination.nextCursor value from the previous answer.
folder filter
folderId yok
all
It lists the ideas accessible by the API key without distinguishing between folders.
folderId=null
without folder
It only returns ideas that are not bound to the folder. The empty folderId value is also interpreted as null.
folderId=fld_123
single folder
It only lists ideas linked to the given folder.
sıralama
createdAt desc
Results are sorted by creation date, newest to oldest.
The folderId filter produces different listing behavior depending on how it is sent.
Cevaplar
200
Paged list of ideas.
cURL
curl "https://api.xplanner.co/v1/ideas?accountId=acc_123&folderId=fld_123&limit=20" \ -H "Authorization: Bearer $XPLANNER_API_KEY"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": false, "workspaceId": "wrk_123", "xUserId": "123456789", "createdAt": "2026-05-15T09:00:00.000Z", "updatedAt": "2026-05-15T09:00:00.000Z" } ], "pagination": { "nextCursor": null }, "requestId": "req_123"}