> 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/justpush-api/the-glossary.md).

# The Glossary

Many items on the list will provide links to articles, offering deeper insights into the concepts and practical applications of the associated words.

<details>

<summary>Topic</summary>

A **topic** is a group of messages collected in the same thread. Topics are viewed in a conversation-like view. A message on a timeline.

**Part of:**

* A (or multiple) [users](#user)
* Can have (multiple) [message](#message)(s)

</details>

<details>

<summary>Message</summary>

A **message** holds various elements. Together they form a message. The bare minimum is a title.

**Part of:**

* A single [topic](#topic)
* A single [user](#user)

**Requires:**

* A [title](#title)

**Can have:**

* A body
* An [acknowledgement](#acknowledgement)
* One or more [images](#images)
* One or more [buttons](#button)
* One or more [button groups](#button-groups)
* A set [priority](#priority)
* A set [sound](#sound)

</details>

<details>

<summary>Title</summary>

A word or phrase that represents a message or a topic. It is recommended to use descriptive or summarizing words and phrases.

**Part of:**

* A [message](#message)
* A [topic](#topic)

</details>

<details>

<summary>Body</summary>

The body holds the actual contents of the message. A body is the content of the message itself. It can only hold text. Additional elements such as images and buttons can be added through the messages.

</details>

<details>

<summary>Sound</summary>

A sound can be sent when a [message](#message) is sent. A sound will be played on the device.

**Part of:**

* A [message](#message)

</details>

<details>

<summary>Priority</summary>

A [message](#message) can have a priority. This alters the look and feel of the message.

**Part of:**

* A [message](#message)

</details>

<details>

<summary>Button Groups</summary>

A button group is a set of [buttons](#button) combined in a group.

**Part of:**

* A [message](#message)

</details>

<details>

<summary>Button</summary>

A button that links to the defined URL. A [user](#user) can set the button through the API.

**Part of:**

* A [message](#message)
* of a [button group](#button-groups)

</details>

<details>

<summary>Images</summary>

A [message](#message) can hold one or more [images](#images).

**Part of:**

* A [message](#message)

</details>

<details>

<summary>Acknowledgement</summary>

An acknowledgement is a [message](#message) part. It determines that the [message](#message) has to be acknowledged. A record is kept of what [device](#device) has acknowledged the message. Within a message there can be a callback URL and params.

**Part of:**

* A [message](#message)

</details>

<details>

<summary>User</summary>

A single person, identified by an email.

**Has:**

* Access to one of our apps
* Has a personal email (Email API)

**Can:**

* Create / Delete and Update [Topics](#topic)
* Create [messages](#message)

</details>

<details>

<summary>Device</summary>

A device is part of a [user](#user) and determines a unique device based on its own identifier. Within the app, a device is registered to receive push messages.

**Part of:**

* A [user](#user)

</details>

<details>

<summary>JustPush Email</summary>

Your personal JustPush email. Any email will be forwarded as a push message.

**Part of:**

* [User](#user)

</details>

<details>

<summary>API Key</summary>

Your personal authentication token. This is used for authentication on the API.

**Part of:**

* [User](#user)

</details>

<details>

<summary>MCP</summary>

**MCP** (Model Context Protocol) is an open standard that lets AI assistants like Claude connect to external tools. JustPush ships an MCP server, so an assistant can send [messages](#message), list [topics](#topic), and create new topics on your behalf — acting as you, only ever on your own data. No [API key](#api-key) is needed; sign-in uses a one-time email code. See [Connecting JustPush to Claude (MCP)](https://github.com/hniehorster/justpush-backend/blob/main/introduction/dev-tools/mcp-server.md).

**Part of:**

* [User](#user)

</details>

***

## 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/the-glossary.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.
