Update task status

PATCH

/tasks/{id}/status

Updates a task's status. Both admins and employees can use this endpoint.

Ownership rule: Employees can only update their own tasks. Admins can update any task.

When status changes to COMPLETED, completedAt is automatically set.
When status changes away from COMPLETED, completedAt is cleared.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/jsonRequired

Example

{
    "status": "COMPLETED"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PATCH '/tasks/cm5task001/status' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "status": "COMPLETED"
}'

Responses

🟢200

application/json

Status updated

Body

Example

{
    "success": true,
    "data": {
        "id": "cm5task001",
        "title": "Build Dashboard UI",
        "status": "COMPLETED",
        "completedAt": "2026-02-25T16:30:00.000Z"
    },
    "message": "Task status updated successfully"
}

🟠403

🟠404NotFound

Modified at 2026-02-22 18:59:05

Delete task

Update task transaction hash