Reference · the tools · gateway
unsubscribe_topic
Safe to repeatRemove a topic subscription
What it does
Stop delivering a topic to a session: the subscription goes (its number from list_topics). Messages stay kept.
What it needs to know
- subscription
- Its number, from list_topics.
- 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.