Utilities

Start, list, cancel, or clear timers

Action dispatcher for the Pomodoro / countdown timer manager. start (preset or duration_seconds plus optional label/sound), list (active timers), cancel (by timer_id), clear (all).

post/v1/timers

Request

  • Base URL: http://localhost:9998
  • URL: http://localhost:9998/v1/timers
  • Auth: HTTP bearer

Request body

action'start' | 'list' | 'cancel' | 'clear' required
preset'pomodoro' | 'short_break' | 'long_break'

Preset duration. action=start only — alternative to duration_seconds.

duration_secondsinteger

Explicit duration. action=start only.

labelstring

Display label. Optional. Falls back to the preset's default label.

soundboolean

Play a sound when the timer fires. Default true.

timer_idstring

Required for action=cancel.

Response

Action-specific response (timer entry, list, or {ok:true})

object required

Shape depends on action.

Changes

No recorded changes to this operation across all 1 revision of this API.