Projects

Queue a web push notification (what push.send calls)

Changed on

tenant-web-push. The project's own service key only (a function's push.send). Queues one delivery per targeted phone, before anything is sent, and counts them against the organization's daily cap (100 / 1,000 / 10,000 on prototype / hobby / team). A message that does not fit is refused whole. Not lifecycle-gated.

post/projects/v1/{project_id}/push/messages

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/projects/v1/{project_id}/push/messages
  • Auth: HTTP bearer

Path parameters

project_idstring required

Run402 project ID. Public IDs are not UUIDs.

Example:prj_1741340000_0042

Request body

titlestring required
bodystring nullable
urlstring nullable

A path on the app, starting with / (default /), resolved against the origin each phone signed up on.

tagstring nullable

A newer message with the same tag replaces the older one on the phone.

Response

no_subscribers: nobody the message addresses has a phone signed up.

message_idstring required
status'queued' | 'no_subscribers' required
devicesinteger required

Phones the message targets, each one delivery against the daily cap.

next_actionsobject[]

Changes