Update work item

PATCH/v1/work/items/{id}

Signed-in sessionLaunch key product.workOperation work_item_update

People open My tasks at /work: the open project tasks assigned to them across every project, in one table.

Path parameters

idstringRequired

Body

visibility"private" | "tenant"
tagsstring[]
priority"high" | "low" | "normal" | "urgent"
dueAtnull | number
storyPoints1 | 2 | 3 | 5 | 8 | null
nextActionstring
titlestring
descriptionstring
documentCASobject
idempotencyKeystringRequired
expectedAuthorizationVersionstringRequired
expectedItemVersionstringRequired

Returns

accountIdstringRequired
serviceTenancyIdstringRequired
authorizationVersionstringRequired
replayedbooleanRequired
evaluatedAtnumberRequired
itemobjectRequired

Errors

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

curl "$SPECIFY_API_ORIGIN/v1/work/items/<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>","expectedItemVersion":"<expectedItemVersion>"}'

{ "result": { "accountId": "<accountId>", "serviceTenancyId": "<serviceTenancyId>", "authorizationVersion": "<authorizationVersion>", "replayed": true, "evaluatedAt": 1, "item": { "id": "<id>", "itemKey": "<itemKey>", "title": "<title>", "description": "<description>", "nextAction": "<nextAction>", "priority": "high", "storyPoints": 1, "tags": [ "<tag>" ], "visibility": "private", "ownerActorId": "<ownerActorId>", "columnId": "<columnId>", "dueAt": "<dueAt>", "createdAt": 1, "updatedAt": 1, "completedAt": "<completedAt>", "archivedAt": "<archivedAt>", "archiveState": "active", "version": "<version>" } } }

Update work item

Headers

Path parameters

Body

Returns

Errors