MonetaryAI / Docs
API ReferenceWeb push

Enqueue a tenant-scoped web push message

Default ADMIN access; live company permission is checked again at delivery. The request UUID is idempotent. A 202 means queued, not Firebase acceptance or browser delivery. Company permission: `enqueueWebPushMessage`. Defaults: ADMIN. Current company role permissions and active membership are checked on every request; signed legacy role claims alone do not authorize this operation.

POST
/api/v1/push/messages

Authorization

bearerAuth
headerAuthorizationBearer <token>

Obtained from POST /api/v1/auth/login, on the tenant's own subdomain. Presenting it on another tenant's subdomain is a 403.

Request Body

application/json
  1. body
body*string
Length0 <= length <= 500
clickPath?string
Match/(?!/)[A-Za-z0-9/_-]*
Length0 <= length <= 200
recipientMembershipId*string
Formatuuid
requestId*string
Formatuuid
title*string
Length0 <= length <= 120

Response Body

Message and per-device deliveries queued

application/json
  1. response
devices?integer
Formatint32
id?string
Formatuuid
curl -X POST 'https://api.monetaryai.uz/api/v1/push/messages' \  -H 'Content-Type: application/json' \  -d '{  "body": "string",  "recipientMembershipId": "6f55ad4b-e125-4e04-8399-cabc871a397d",  "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6",  "title": "string"}'
{  "devices": 0,  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"}