Update Task

Updates one or more fields on an existing task.

PATCH /api/v1/tasks/{id}

cURL

curl -X PATCH https://kliio.app/api/v1/tasks/task-uuid-... \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "done" }'

200

{
  "success": true,
  "data": {
    "id": "task-uuid-...",
    "name": "Design homepage mockup",
    "status": "done",
    "estimated_hours": 8,
    "billable": true,
    "rate": 120,
    "total_seconds": 28800,
    "phase_id": "phase-uuid-...",
    "created_at": "2025-03-20T09:00:00.000Z"
  }
}

Headers

Authorization · string · required

Bearer YOUR_API_KEY

Path Parameters

id · string · required

UUID of the task to update.

Body

Send only the fields you want to change. At least one field is required.

name · string

Updated task name.

description · string

Updated description.

status · string

New status. One of: todo, in_progress, done.

estimated_hours · number

Updated estimated hours.

billable · boolean

Updated billable flag.

rate · number

Updated hourly rate.

phase_id · string

UUID of a project phase to assign the task to, or null to unassign.

Response

success · boolean

true on update.

data · object

The updated task object.

cURL

curl -X PATCH https://kliio.app/api/v1/tasks/task-uuid-... \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "done" }'

200

{
  "success": true,
  "data": {
    "id": "task-uuid-...",
    "name": "Design homepage mockup",
    "status": "done",
    "estimated_hours": 8,
    "billable": true,
    "rate": 120,
    "total_seconds": 28800,
    "phase_id": "phase-uuid-...",
    "created_at": "2025-03-20T09:00:00.000Z"
  }
}