---
module: notifications
last_verified_commit: 0000000
---

# Notifications — permissions

> _Scaffolded stub — replace with proper documentation when this module is next touched._

Returned by `NotificationsModule.get_permissions()`
(relative names; the registry namespaces them as `notifications.<name>`).

| Permission | Allows | Required by |
|------------|--------|-------------|
| `notifications.templates.read` | _Describe what this allows._ | _List the endpoints._ |
| `notifications.templates.write` | _Describe what this allows._ | _List the endpoints._ |
| `notifications.preferences.read` | _Describe what this allows._ | _List the endpoints._ |
| `notifications.preferences.write` | _Describe what this allows._ | _List the endpoints._ |
| `notifications.logs.read` | _Describe what this allows._ | _List the endpoints._ |
| `notifications.send` | _Describe what this allows._ | _List the endpoints._ |
| `notifications.settings.read` | _Describe what this allows._ | _List the endpoints._ |
| `notifications.settings.write` | _Describe what this allows._ | _List the endpoints._ |

## Role assignment

See `backend/app/core/auth/permissions.py` for the canonical role table.

## Adding a new permission

1. Add the relative name to `get_permissions()` in
   `backend/app/modules/notifications/__init__.py` (or `module.py`).
2. Add the namespaced form to the relevant role(s) in
   `backend/app/core/auth/permissions.py`.
3. Add a row to the table above.
4. Annotate the endpoint(s) with `Depends(require_permission(...))`.
5. Update `frontend/app/config/permissions.ts` if it gates UI.