Update idea

PATCH/v1/ideas/{id}

Signed-in sessionLaunch key product.ideasOperation ideas_update

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

Path parameters

idstringRequired

Body

status"archived" | "exploring" | "inbox"
tagsstring[]
priority"high" | "low" | "normal"
bodystring
titlestring
projectLinksfalse | true
idempotencyKeystringRequired
expectedAuthorizationVersionstringRequired
expectedIdeaRevisionstringRequired

Returns

permission"permitted"Required
ideaobjectRequired
replayedbooleanRequired
accountIdstringRequired
serviceTenancyIdstringRequired
authorizationVersionstringRequired
evaluatedAtnumberRequired

Errors

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

curl "$SPECIFY_API_ORIGIN/v1/ideas/<id>" \ -X PATCH \ -H "Authorization: Bearer $SPECIFY_SESSION_TOKEN" \ -H "X-Specify-Account-Id: <accountId>" \ -H "X-Specify-Service-Tenancy-Id: <serviceTenancyId>" \ -H "Content-Type: application/json" \ -d '{"idempotencyKey":"retry-1","expectedAuthorizationVersion":"<expectedAuthorizationVersion>","expectedIdeaRevision":"<expectedIdeaRevision>"}'

{ "result": { "permission": "permitted", "idea": { "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>" }, "replayed": true, "accountId": "<accountId>", "serviceTenancyId": "<serviceTenancyId>", "authorizationVersion": "<authorizationVersion>", "evaluatedAt": 1 } }

Update idea

Headers

Path parameters

Body

Returns

Errors