Replace the push token on an existing subscription
Identity-preserving token rotation. Requires a matching subscription_credential (credential-less Endpoints return 401). Inactive Subscriptions return 409 (`subscription_inactive`). Keeps subscription_id, contact association, verification, and delivery history. Another active holder of the new token is made Inactive. Also refreshes Subscription and Contact Properties when provided (does not increment session_count).
Identity-preserving token rotation. Requires a matching subscription_credential
(credential-less Endpoints return 401). Inactive Subscriptions return 409
(subscription_inactive). Keeps subscription_id, contact association, verification,
and delivery history. Another active holder of the new token is made Inactive.
Also refreshes Subscription and Contact Properties when provided (does not increment session_count).
mobileAppIdX-ComRaid-App-Id<token>Publishable mobile app id (cr_app_...)
id*stringuuidapplication/json- body
token*stringplatform*string"android""ios"provider?string"fcm""apns"apns_environment?string"sandbox""production"app_version?stringsdk_version?stringlocale?stringtimezone?stringlanguage?stringcountry?stringdevice?metadata?subscription_credential*stringRequired ownership credential for this subscription
Token replaced (or refreshed when unchanged)
application/json- response
subscription_id*stringuuidanonymous*booleanverified*booleanplatform*string"android""ios"provider*string"fcm""apns"token_version*integercurl -X POST 'https://api.comraid.io/mobile/subscriptions/497f6eca-6276-4993-bfeb-53cbbbba6f08/token' \ -H 'Content-Type: application/json' \ -d '{ "token": "new-fcm-or-apns-token", "platform": "android", "provider": "fcm", "subscription_credential": "high-entropy-secret"}'{ "subscription_id": "aa11a4c2-a467-43db-b413-c4ab0f5cf627", "anonymous": true, "verified": true, "platform": "android", "provider": "fcm", "token_version": 0}Attach a contact identity to a subscription POST
Upserts a contact for external_user_id and binds this subscription. Requires a matching subscription_credential (credential-less Endpoints return 401). Inactive Subscriptions return 409 (`subscription_inactive`). When the project has identity_verification_required, jwt (RS256 JWT for Identity verification) is mandatory and must verify. When optional, omit jwt for an unverified bind, but any supplied invalid jwt is rejected (never downgraded).
Record an SDK session and refresh Properties POST
Increments Subscription `session_count`, advances `last_seen_at` / Contact `last_active_at`, and upserts first-class Properties (timezone, locale, language, country, app/OS versions). Distinct from customer Attributes. Requires a matching subscription_credential (credential-less Endpoints return 401). Inactive Subscriptions return 409 (`subscription_inactive`).