Create Time Entry

Logs a manual time entry against a project, optionally linked to a task.

POST /api/v1/time-entries

cURL

curl -X POST https://kliio.app/api/v1/time-entries \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "proj-uuid-...",
    "task_id": "task-uuid-...",
    "hours": 3,
    "date": "2025-03-20",
    "description": "Wireframing",
    "hourly_rate": 120
  }'

201

{
  "success": true,
  "data": {
    "id": "te-uuid-...",
    "hours": 3,
    "hourly_rate": 120,
    "date": "2025-03-20",
    "description": "Wireframing",
    "task_id": "task-uuid-...",
    "project": { "id": "proj-uuid-...", "name": "Acme Rebrand" },
    "created_at": "2025-03-20T18:00:00.000Z"
  }
}

Headers

Authorization · string · required

Bearer YOUR_API_KEY

Body

project_id · string · required

UUID of the project. Must belong to your account.

hours · number · required

Hours worked. Must be greater than 0.

date · string · required

Date of work in YYYY-MM-DD format.

task_id · string

Optional UUID of a task within the project to link this entry to.

description · string

Optional description of the work done.

hourly_rate · number

Hourly rate to apply. Useful for billing calculations.

Response

success · boolean

true on creation.

data · object

The newly created time entry, including an embedded project.

cURL

curl -X POST https://kliio.app/api/v1/time-entries \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "proj-uuid-...",
    "task_id": "task-uuid-...",
    "hours": 3,
    "date": "2025-03-20",
    "description": "Wireframing",
    "hourly_rate": 120
  }'

201

{
  "success": true,
  "data": {
    "id": "te-uuid-...",
    "hours": 3,
    "hourly_rate": 120,
    "date": "2025-03-20",
    "description": "Wireframing",
    "task_id": "task-uuid-...",
    "project": { "id": "proj-uuid-...", "name": "Acme Rebrand" },
    "created_at": "2025-03-20T18:00:00.000Z"
  }
}