Push Devices API
Notifications are persisted in the API and also delivered to registered devices when a provider is configured.
| Method | Path | Description |
|---|---|---|
| POST | /devices | Register or refresh an install token |
| DELETE | /devices | Unregister an install token |
| GET | /devices/status | List configured delivery providers |
{
"platform": "android",
"provider": "fcm",
"token": "provider-token",
"locale": "en-US",
"appVersion": "1.4.0"
}
Platforms are android and ios; providers are fcm, rustore, and
apns. iOS requires apns; Android uses fcm or rustore. Registration is
safe on every app launch and token rotation. A provider/token identifies an
installation, so registering it under another account moves ownership.
GET /devices/status returns { "enabled": ["fcm"] }. An empty list means
notifications remain stored but no configured provider can deliver them.