Push credentials APL-07
Configure APNs, FCM and Web Push for an Application so it can send push notifications.
| Who can use it | Owner or applications.manage with a User token (write); app key / owner (read) |
|---|---|
| Where it is | /dev/apps/:appId/push · link: https://hub.substratalapps.com/dev/apps/:appId/push or substratal://dev/apps/:appId/push |
| Available on | Web (PWA), iOS / iPadOS, Android, Windows, Linux (GNOME), macOS |
| Phase | Phase 2 |
What you can do here
- Add — 201; 409 push_credential_exists → Edit; 422 invalid_push_credential → field error; 400 user_token_required never happens in the Hub (User token)
- Fetch one — on Edit
- Save — 409 invalid_status_transition
- Remove — 204
Related guides
- Registering and managing applications — Register an app, configure redirect URIs, settings and roles, set up push, and the review lifecycle.
- 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) | — | tabpanel (route segment) |
| iOS / iPadOS | — | Segment content |
| Android | Planned | Tab content |
| Windows | — | SelectorBar item content |
| Linux (GNOME) | — | AdwViewStack page |
| macOS | — | Tab content inside detail |
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 | /applications/{id}/push-credentials | List the push providers an Application has configured (the owner, the app's own key, or applications.manage) |
| POST | /applications/{id}/push-credentials | Configure one push provider (the owner or applications.manage, User token only) |
| GET | /applications/{id}/push-credentials/{provider} | Fetch one provider's configuration |
| PATCH | /applications/{id}/push-credentials/{provider} | Replace key material, change non-secret fields, or re-enable a failed credential (User token only) |
| DELETE | /applications/{id}/push-credentials/{provider} | Remove a push provider (User token only) |
Every call sends Substratal-Version: 1. Paths are at the host root, with no /v1.