Skip to main content

Update a task

PATCH 
/api/v1/tasks/:task_id

Updates a task's payload, title, or assignee. state is never directly writable — move it with a transition; sending a state field is rejected as an unknown field (VALIDATION_FAILED). payload is shallow-merged over the existing payload (PATCH semantics): keys the request omits are preserved. The payload is caller-owned; the automation result lives in the read-only last_result field, which no patch can reach. The merged payload is validated against the workflow's payload_schema.

Request​

Responses​

Task updated