Topics

A topic is like a custom channel for your push messages. Create it with a POST, update it with a PUT, and optionally give it a snazzy title so it’s not just "Topic #generic".

Topics let you group and organize your messages. Want a separate feed for "Server Alerts", "Uptime Pings", or "Pizza Tracker™"? That’s what topics are for.

• Create with POST – optionally include a title for clarity.

• Update with PUT – change the title later if you rethink your naming scheme (we’ve all been there).

• Use in Subscriptions – topics make it easy for others to follow your messages, or for your systems to send targeted updates.

Components

• Title

• Avatar

Use Cases

Use topics to send messages to specific streams or audiences, without spamming everything and everyone.

✅ DevOps: "Staging Alerts", "Production Errors", "Deploy Logs" ✅ Projects: "Team Alpha Updates" vs. "Marketing Launches" ✅ Fun Stuff: "Dad Jokes of the Day" or "Cat Cam Alerts"

Bad Ideas

❌ Leaving every topic untitled. ("topic-93f3-bc49" is not memorable.) ❌ Renaming topics every five minutes. (Pick a name. Commit to it.) ❌ Using one topic for everything. (Might as well just use email.)

---