Skip to main content

Start Timer on Unit

POST 

/api/repairs/:repair/lines/:line/timer/start

Starts the caller's labour timer on a unit. A timer the caller has running on another unit is paused (and costed) first; one already running on this unit is returned as is. No body.

Required scope: repairs:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Response data:

  • entries — the unit's time entries. Each time entry: id, repair_order_line_id, user_id, started_at, ended_at (null while running), seconds (live for a running entry), is_running, source (timer or manual), is_capped (stopped by the daily timer cap and waiting to be confirmed), note, repair_order_cost_id (the labour cost line it is costed on), created_at.
  • total_seconds — all time on the unit.
  • estimated_minutes — sum of the found issue types' standard minutes (null when none).
  • running_entry — the caller's running timer on this unit, or null.
  • labour_cost — the unit's labour cost line (same fields as Get Repair Cost), or null when no time is recorded.
  • entry — the running time entry.

Authentication: Bearer token with the repairs:write scope.

Request​

Responses​

OK

Response Headers
    Content-Type