Devices & notifications NTF-03
Where push notifications reach this person, and controls for this device.
| Who can use it | Self |
|---|---|
| Where it is | /account/devices · link: https://hub.substratalapps.com/account/devices or substratal://account/devices |
| Available on | Web (PWA), iOS / iPadOS, Android, Windows, Linux (GNOME), macOS |
| Phase | Phase 2 |
What you can do here
- Turn off on this device — and stop re-registering until the user turns it back on
- Test — 429 → "Try again later (10 tests per hour)"; 409 push_not_configured → "Push isn't set up for this app yet"
Related guides
- Notifications and push — Your inbox, turning push on per device, and what security alerts mean.
- Substratal on Linux — Install and run the Hub on GNOME and other Linux desktops, how it signs in, how notifications arrive, and Linux-only tips.
On your platform
| App | Status | How it's built |
|---|---|---|
| Web (PWA) | — | Grouped settings rows in main pane |
| iOS / iPadOS | — | Inset-grouped List/Form |
| Android | Planned | Grouped ListItems |
| Windows | — | Page of SettingsCards |
| Linux (GNOME) | — | AdwPreferencesPage |
| macOS | — | Detail column Form(.grouped); per-row save |
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 |
|---|---|---|
| GET | /users/{id}/settings | Fetch global Settings (self, or platform users.list) |
| GET | /users/{id}/devices | List a User's push devices (self, the app's own key, or users.list) |
| PATCH | /users/{id}/devices/{deviceId} | Update a device's name, app version, environment, or rotated token (self or the app's own key) |
| DELETE | /users/{id}/devices/{deviceId} | Unregister a device (self, the app's own key, or users.manage) |
| POST | /users/{id}/devices/{deviceId}/test | Send a test push to one device and wait for the provider's answer (self or the app's own key) |
Every call sends Substratal-Version: 1. Paths are at the host root, with no /v1.