Skip to main content
POST
Transition a project task
Moves a task through the canonical task status machine. The body is strict: id and to. A disallowed move answers 409 invalid_state with a message naming the allowed targets, and changes nothing. A task with no assignee cannot move to ASSIGNED (409 invalid_state): assigning is done by a person in Console. Moving a task starts no work. Authority is the same as Update project task. Success is 200 with the post-write ProjectTaskDetail. Only a project’s ordinary tasks are here. A factory task is read and changed through the factory task operations, and a task with no project is never returned. Assigning a task is done by a person in Console.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Headers

Idempotency-Key
string

Optional logical intent key. A same-key retry within 24 hours returns the recorded result without writing again.

Required string length: 1 - 255

Path Parameters

taskId
string
required

The task ID, as GET /api/v2/projects/getTask returns it.

Minimum string length: 1

Body

application/json

Move a task through the canonical task status machine.

to
enum<string>
required

The target status. ICEBOX→BACKLOG|READY|CANCELLED, BACKLOG→READY|ASSIGNED|CANCELLED, READY→ASSIGNED|BACKLOG|CANCELLED, ASSIGNED→IN_PROGRESS|READY|BACKLOG|BLOCKED|CANCELLED, IN_PROGRESS→IN_REVIEW|BLOCKED|ASSIGNED|CANCELLED, BLOCKED→IN_PROGRESS|ASSIGNED|CANCELLED, IN_REVIEW→COMPLETE|IN_PROGRESS, COMPLETE→BACKLOG, CANCELLED→BACKLOG. A task with no assignee cannot move to ASSIGNED.

Available options:
ICEBOX,
BACKLOG,
READY,
ASSIGNED,
IN_PROGRESS,
BLOCKED,
IN_REVIEW,
COMPLETE,
CANCELLED

Response

Success

data
object
required
meta
object
required