> ## Documentation Index
> Fetch the complete documentation index at: https://docs.testyourappnow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifications

> List, add, or delete user notifications.

List, add, or delete notifications. Dispatch the desired operation with the `action` field in the request body.

## Actions

| Action   | Description                              |
| -------- | ---------------------------------------- |
| `list`   | List notifications with optional filter. |
| `add`    | Create a new notification.               |
| `delete` | Remove a notification by `id`.           |

## Request body

<ParamField body="action" type="string" required>
  One of `list`, `add`, or `delete`.
</ParamField>

<ParamField body="data" type="object">
  Payload for the selected action. Required for `add` and `delete`.

  <Expandable title="list">
    <ParamField body="filter" default="all" type="string">
      `all`, `unread`, `visual`, `health`, or `flow`.
    </ParamField>
  </Expandable>
</ParamField>

## Response

<ResponseField name="data" type="array">
  Returned by `list`. Each Notification includes `id`, `user_id`, `type`, `title`, `body`, `test_kind`, `link`, `read_at`, `dismissed_at`, and `created_at`.
</ResponseField>

<ResponseField name="message" type="string">
  Human-readable status message.
</ResponseField>