Create work item

POST/v1/work/items

Signed-in sessionLaunch key product.workOperation work_item_create

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

Body

visibility"private" | "tenant"
tagsstring[]
ownerActorIdstring
priority"high" | "low" | "normal" | "urgent"
dueAtnumber
storyPoints1 | 2 | 3 | 5 | 8
nextActionstring
descriptionstring
columnKey"capture" | "done" | "focus" | "ready" | "review" | "waiting"
idempotencyKeystringRequired
titlestringRequired
expectedAuthorizationVersionstringRequired

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" \ -X POST \ -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","title":"<title>","expectedAuthorizationVersion":"<expectedAuthorizationVersion>"}'

{ "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>" } } }

Create work item

Headers

Body

Returns

Errors