Create Task

Creates a new task under a project.

POST /api/v1/tasks

cURL

curl -X POST https://kliio.app/api/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "proj-uuid-...",
    "name": "Design homepage mockup",
    "estimated_hours": 8,
    "billable": true,
    "rate": 120
  }'

201

{
  "success": true,
  "data": {
    "id": "task-uuid-...",
    "name": "Design homepage mockup",
    "description": null,
    "status": "todo",
    "estimated_hours": 8,
    "billable": true,
    "rate": 120,
    "total_seconds": 0,
    "phase_id": null,
    "project": { "id": "proj-uuid-...", "name": "Acme Rebrand" },
    "created_at": "2025-03-20T09:00:00.000Z"
  }
}

Headers

Authorization · string · required

Bearer YOUR_API_KEY

Body

project_id · string · required

UUID of the project this task belongs to. Must belong to your account.

name · string · required

Task name.

description · string

Optional task description.

status · string

Initial status. One of: todo (default), in_progress, done.

estimated_hours · number

Estimated hours to complete the task.

billable · boolean

Whether this task is billable. Defaults to false.

rate · number

Hourly rate for this task. Overrides the project rate when set.

phase_id · string

UUID of a project phase to assign this task to. The phase must belong to the same project.

Response

success · boolean

true on creation.

data · object

The newly created task, including an embedded project object.

cURL

curl -X POST https://kliio.app/api/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "proj-uuid-...",
    "name": "Design homepage mockup",
    "estimated_hours": 8,
    "billable": true,
    "rate": 120
  }'

201

{
  "success": true,
  "data": {
    "id": "task-uuid-...",
    "name": "Design homepage mockup",
    "description": null,
    "status": "todo",
    "estimated_hours": 8,
    "billable": true,
    "rate": 120,
    "total_seconds": 0,
    "phase_id": null,
    "project": { "id": "proj-uuid-...", "name": "Acme Rebrand" },
    "created_at": "2025-03-20T09:00:00.000Z"
  }
}