BettikDocsSign in

Reference · the tools · timers

change_timer

Safe to repeat

Pause, resume, remove or rezone a timer

What it does

Pause a timer (it stays, and fires nothing), resume it (from its next time after now; nothing it missed while paused fires), remove it, or change its zone (action zone, with tz).

What it needs to know

timer
Its number, from list_timers.
action
One of pause, resume, remove, zone.
tz · optional
For action zone: an IANA zone to pin it to, or "person" to follow the person's current zone.
box · optional
Which box: its name and account, "home.frank" or "jordan.northwind", or just "home" when only one of your boxes is called that. Omit it for your current box (switch_box changes it; list_boxes says which it is).
session_box · optional
The box this session runs on, if it runs on one of yours: its name, as the on-box instructions give it ("frankh90.hemlane"). With it, a call that names no box is checked against your current box.

Where it lands

On one of your boxes: the one named in box, or your default box when none is named.