Reference · the tools · gateway
list_topics
Read-onlyTopics on this box's gateway
What it does
The topics on this box's messaging gateway: how many messages each keeps and when the last came, and who gets them -- the sessions subscribed to each, and how many messages each has not had yet. With a topic, also its last few messages, and what the gateway last did with each subscribed session (delivered, woke it, why it is stuck). Messages are kept 7 days (at most 1,000 a topic), delivered or not.
What it needs to know
- topic · optional
- One topic, with its latest messages.
- 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. It changes nothing.