---
title: "Manage timer"
method: POST
path: "/timer"
tags: ["[v1] Timer"]
deprecated: true
---

# Manage timer

`POST /timer`

> **Deprecated.**

Deprecated. Support ends on November 1, 2026. Use `GET /v3/timer/status`, `POST /v3/timer/start`, `POST /v3/timer/stop`, or `DELETE /v3/timer` for the corresponding action.

## Request body

- object
  - `action` 'status' | 'start' | 'stop' | 'cancel', required — either `status`, `start`, `stop` or `cancel`
  - `task_id` integer — start a task with a given task
  - `started_at` string — timer will count time since this date only when `action` = `start`
  - `stopped_at` string — timer will count time to this date only when `action` = `stop`
  - `timer_id` union — Running timer id used by `stop` and `cancel`. When omitted for `cancel`, the current user timer is cancelled.
    - integer
    - string

## Response `200`

OK

- object
  - `isTimerRunning` boolean
  - `elapsed` number
  - `entry_id` union
    - number
    - string
  - `timer_id` union
    - number
    - string
  - `start_time` string

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.dev/timecamp/apis/timecamp-api.md) · [All operations](https://skmtc.dev/timecamp/apis/timecamp-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/timecamp/timecamp-api/revisions/047f6ac362aa/schema)