> For the complete documentation index, see [llms.txt](https://docs.justpush.io/introduction/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.justpush.io/introduction/objects/topics.md).

# Topics

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&#x20;*****everything*****.** (Might as well just use email.)

***

***

## Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.justpush.io/introduction/objects/topics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
