Track Time

POST /v1/project/time-entries
{
  "task_id": "task_01HXYZTASK1",
  "user_id": "usr_01HXYZ1111",
  "duration_seconds": 5400,
  "date": "2026-07-10",
  "note": "Completed typography token audit"
}

POST /v1/project/time-entries/start
{
  "task_id": "task_01HXYZTASK1",
  "user_id": "usr_01HXYZ1111"
}

{
  "timer_id": "tmr_01HXYZTMR1",
  "started_at": "2026-07-10T14:00:00Z",
  "status": "running"
}

POST /v1/project/time-entries/stop
{
  "timer_id": "tmr_01HXYZTMR1",
  "note": "Worked on component inventory"
}

GET /v1/project/time-entries?project_id=proj_01HXYZ9876&user_id=usr_01HXYZ1111&date_from=2026-07-01&date_to=2026-07-31

GET /v1/project/projects/proj_01HXYZ9876/time-report?period=2026-07

{
  "project_id": "proj_01HXYZ9876",
  "period": "2026-07",
  "total_seconds": 432000,
  "by_user": [
    { "user_id": "usr_01HXYZ1111", "display_name": "Sam Chen", "total_seconds": 216000 },
    { "user_id": "usr_01HXYZ2222", "display_name": "Priya Nair", "total_seconds": 216000 }
  ],
  "by_task": [
    { "task_id": "task_01HXYZTASK1", "title": "Design system audit", "total_seconds": 108000 }
  ]
}