Reference · the tools · timers
change_timer
Safe to repeatPause, 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.