---
title: "Start tracking a task"
method: POST
path: "/tasks/{tid}/timer/start"
tags: ["time"]
---

# Start tracking a task

`POST /tasks/{tid}/timer/start`

## Request

- Base URL: `https://task.igordudnek.com/api/v1`
- URL: `https://task.igordudnek.com/api/v1/tasks/{tid}/timer/start`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `lt_access`

Stops the timer running on another task in the same call (one running timer per person). Needs edit access to the task's project; AI agents get 403. Extension tokens are always recorded as source=extension.

## Request body

- StartTimerRequest
  - `source` 'web' | 'workday': client hint; ignored for extension tokens

## Response `200`

OK

- TimerStarted
  - `already_running` boolean
  - `started` CurrentTimer, required
    - `billable` boolean
    - `duration_sec` integer
    - `edited` boolean
    - `ended_at` string, date-time, nullable
    - `id` string, uuid, required
    - `note` string
    - `project_id` string, uuid
    - `running` boolean, required
    - `seconds` integer, required: duration if closed, elapsed so far if running
    - `source` 'web' | 'workday' | 'extension' | 'manual', required
    - `started_at` string, date-time, required
    - `task_id` string, uuid, required
    - `user_id` string, uuid
    - `project_code` string, required
    - `project_name` string
    - `task_number` integer, required
    - `task_title` string, required
  - `stopped` TimeEntry, required
    - `billable` boolean
    - `duration_sec` integer
    - `edited` boolean
    - `ended_at` string, date-time, nullable
    - `id` string, uuid, required
    - `note` string
    - `project_id` string, uuid
    - `running` boolean, required
    - `seconds` integer, required: duration if closed, elapsed so far if running
    - `source` 'web' | 'workday' | 'extension' | 'manual', required
    - `started_at` string, date-time, required
    - `task_id` string, uuid, required
    - `user_id` string, uuid

---

[API](https://skmtc.dev/loopertask/apis/loopertask-api.md) · [All operations](https://skmtc.dev/loopertask/apis/loopertask-api/llms.txt) · [OpenAPI document](https://skmtc.dev/loopertask/apis/loopertask-api/revisions/5d9903f15162?raw)