---
title: "Subscribe To Push"
method: POST
path: "/api/notifications/subscribe"
tags: ["notifications"]
---

# Subscribe To Push

`POST /api/notifications/subscribe`

## Request

- Base URL: `https://api.erux.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.erux.ai/api/notifications/subscribe`
- Auth: none declared

Register or reactivate a client device Web Push subscription.

## Request body

- PushSubscriptionRequest: Payload sent by client when subscribing to PWA push notifications
  - `endpoint` string, required: W3C Web Push endpoint URL
  - `keys` PushSubscriptionKeys, required: Cryptographic client keys for Web Push (VAPID)
    - `p256dh` string, required: Client P-256 public key
    - `auth` string, required: Client auth authentication secret
  - `platform` string, nullable: Platform: 'ios', 'android', 'desktop', 'safari_macos'
  - `is_standalone` boolean, nullable: Whether app is running in standalone PWA mode
  - `user_agent` string, nullable: Client user agent string
  - `settings` object, nullable: Client routine preferences
  - `user_id` string, nullable: User UUID if authenticated

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/erux/apis/erux-astrology-ephemeris-engine.md) · [All operations](https://skmtc.dev/erux/apis/erux-astrology-ephemeris-engine/llms.txt) · [OpenAPI document](https://skmtc.dev/erux/apis/erux-astrology-ephemeris-engine/revisions/9dc718df71b0?raw)