SetStatus

[POST] .../v1/projecttask/setstatus

Changes task status Use this method to change a task workflow status to New, InProgress, Done or Canceled. The method updates the status, fills close metadata when the persistent rules require it, emits task status notifications/webhooks and returns UpdateResult. The request body must contain id and a non-default status, the caller needs task status permission and missing body, invalid status, denied access, missing task, close-permission restrictions or persistent errors are returned as HTTP 200 ErrorResult business errors.

Request Parameters

Name Type Required Description
id Int64 Required Task ID.
status String Required New status: New, InProgress, Done, Canceled. Allowed values: Default, New, InProgress, Done, Canceled.

Request Example

{
  "id": 101,
  "status": "Done"
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result Update Update operation result.

Response Example

{
  "ok": true,
  "result": {
    "row_affected": 1
  }
}