start_timer
Start a timer to track time spent on a task. Provide task ID; optionally supply board ID to avoid an extra API request.
Instructions
Start a new time tracker on a task for the authenticated user.
Returns the created TimeTracker. The new timer starts in the
running state (ended_at is None); call stop_timer when
work pauses or ends.
board_id is required by the Kanban Tool API but may be omitted
here — when not supplied the tool resolves it via an internal
get_task(task_id) call (one extra HTTP round-trip). Pass it
explicitly when you already have it (e.g. you just listed tasks for a
board) to avoid the second request. Either way, the resulting wire
body sends both ids.
Note: timers are per-user — starting one creates a record for the
authenticated user only. Use whoami if you need to know whose
timer it is.
Common 422: the API rejects starting a timer on a task whose board
you don't have access to with a typed KanbanToolValidationError.
Verify the task is on a board you can list via list_boards.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | ||
| board_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| user_id | No | ||
| board_id | No | ||
| task_id | No | ||
| started_at | No | ||
| ended_at | No | ||
| listed | No | ||
| sprint_id | No | ||
| seconds_from_resumed_sprint | No | ||
| position | No | ||
| highlighted_at | No | ||
| enlist_at | No | ||
| created_at | No | ||
| updated_at | No | ||
| is_running | Yes | True iff the timer is still active (no ``ended_at`` set). |