Turn on notifications NTF-04
Explain, request the OS permission, and register this install for push.
| Who can use it | Self |
|---|---|
| Where it is | /account/devices/enable · link: https://hub.substratalapps.com/account/devices/enable or substratal://account/devices/enable |
| Available on | Web (PWA), iOS / iPadOS, Android, Windows, Linux (GNOME), macOS |
| Phase | Phase 2 |
What you can do here
- Permission granted — 201 new / 200 refresh → store device id; 403 entitlement_required → Hub access disabled for this user: show inbox-only mode; 422 invalid_device_token → log + retry next launch
- Token rotated by OS
- Permission denied — Settings shows "Blocked — Open system settings" deep link
Related guides
- Notifications and push — Your inbox, turning push on per device, and what security alerts mean.
On your platform
| App | Status | How it's built |
|---|---|---|
| Web (PWA) | — | Dialog/sheet with step indicator; each step a URL hash |
| iOS / iPadOS | — | Sheet with NavigationStack push per step |
| Android | Planned | Full-screen dialog with steps |
| Windows | — | ContentDialog steps or page with BreadcrumbBar |
| Linux (GNOME) | — | AdwDialog with AdwNavigationView pages |
| macOS | — | Sheet with paged steps + Back/Continue |
Status is reported by each app's repository; — means that app doesn't report it yet.
For developers: API calls
| Method | Path | What it does |
|---|---|---|
| POST | /users/{id}/devices | Register a push device, or refresh an existing registration (self or the app's own key) |
| PATCH | /users/{id}/devices/{deviceId} | Update a device's name, app version, environment, or rotated token (self or the app's own key) |
Every call sends Substratal-Version: 1. Paths are at the host root, with no /v1.