---
title: "Starts a new time tracker"
method: POST
path: "/time_trackers/start.json"
tags: ["Time trackers"]
---

# Starts a new time tracker

`POST /time_trackers/start.json`

## Request body

- TimeTrackerStart
  - `issue_id` integer
  - `comments` string

## Response `200`

time tracker created

- TimeTracker
  - `id` integer
  - `start` string, date-time
  - `user_id` integer
  - `project_id` integer, nullable
  - `activity_id` integer, nullable
  - `issue_id` integer, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `400` — time tracker not created
- `401` — missing or wrong api key
- `403` — insufficient permissions

## Changes

> 4 revisions in range; 1 could not be searched.

- **2017-07-21** (v1) `7805e8118edd` — 3 breaking
  - removed the request body
  - removed the media type `application/json` for the response with the status `200`
  - removed the media type `application/json` for the response with the status `400`

[Change history](https://skmtc.dev/hicknhack-software/apis/hourglass-api/changes/time_trackers/start.json/post.md)

---

[API](https://skmtc.dev/hicknhack-software/apis/hourglass-api.md) · [All operations](https://skmtc.dev/hicknhack-software/apis/hourglass-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hicknhack-software/hourglass-api/revisions/42cc6d20ab5d/schema)