List ideas

GET/v1/ideas

Signed-in sessionLaunch key product.ideasOperation ideas_page

People and agents capture ideas, search them, and promote one into Work when it is ready.

Query parameters

cursorstring
expectedAuthorizationVersionstring
limitnumber
projectLinksfalse | true
filter"active" | "all" | "archived" | "exploring" | "inbox" | "promoted"Required

Returns

itemsobject[] | nullRequired
nextCursornull | string | nullRequired
permission"not_permitted" | "permitted"Required
canCreatebooleanRequired
allowedVisibilities"private" | "tenant"[]Required
accountIdstringRequired
serviceTenancyIdstringRequired
authorizationVersionstringRequired
evaluatedAtnumberRequired

Errors

400, 401, 403, 404, 409, 429 and 503 return {"error": {"code", "message", "correlationId"}}.

curl "$SPECIFY_API_ORIGIN/v1/ideas?filter=<filter>" \ -H "Authorization: Bearer $SPECIFY_SESSION_TOKEN" \ -H "X-Specify-Account-Id: <accountId>" \ -H "X-Specify-Service-Tenancy-Id: <serviceTenancyId>"

{ "result": { "items": [ { "id": "<id>", "title": "<title>", "body": "<body>", "status": "archived", "priority": "high", "tags": [ "<tag>" ], "visibility": "private", "createdAt": 1, "updatedAt": 1, "archivedAt": "<archivedAt>", "revision": "<revision>", "canEdit": true, "canPromote": true, "linkedWork": "<linkedWork>" } ], "nextCursor": "<nextCursor>", "permission": "not_permitted", "canCreate": true, "allowedVisibilities": [ "private" ], "accountId": "<accountId>", "serviceTenancyId": "<serviceTenancyId>", "authorizationVersion": "<authorizationVersion>", "evaluatedAt": 1 } }

List ideas

Headers

Query parameters

Returns

Errors