Record an SDK session and refresh Properties
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`).
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).
mobileAppIdX-ComRaid-App-Id<token>Publishable mobile app id (cr_app_...)
id*stringuuidapplication/json- body
subscription_credential*stringapp_version?stringsdk_version?stringlocale?stringtimezone?stringlanguage?stringcountry?stringdevice?Session recorded
application/json- response
subscription_id*stringuuidsession_count*integer1 <= valuelast_seen_at*stringdate-timecurl -X POST 'https://api.comraid.io/mobile/subscriptions/497f6eca-6276-4993-bfeb-53cbbbba6f08/session' \ -H 'Content-Type: application/json' \ -d '{ "subscription_credential": "high-entropy-secret", "app_version": "2.0.0", "locale": "en-US", "timezone": "America/New_York", "language": "en", "country": "US", "device": { "os": "Android", "os_version": "14", "model": "Pixel 8" }}'{ "subscription_id": "aa11a4c2-a467-43db-b413-c4ab0f5cf627", "session_count": 1, "last_seen_at": "2019-08-24T14:15:22Z"}Replace the push token on an existing subscription POST
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).
Make a subscription Inactive POST
Marks the Subscription Inactive (`is_active=false`) and clears its subscription credential so the old row cannot be reused. The SDK must immediately register a fresh Subscription on a new Anonymous contact. Requires a matching subscription_credential (credential-less Endpoints return 401).