Notifications

Cancels a campaign while it is still scheduled/queued. Once the fan-out is sending, the campaign is locked. Returns the updated campaign.

Lists authored notification campaigns, scoped to the requester's authority/tenant. Optional cinemaId/chainId narrow the list; they are enforced against the caller's authority.

Authors a notification campaign as a draft (or scheduled). Returns the campaign.

Reads a single authored campaign, including its dispatch stats (sent/failed).

Permanently deletes a draft, scheduled, canceled or failed campaign. Never allowed once the fan-out has claimed it (queued/sending/sent/partially failed).

Partially updates a draft or scheduled campaign — only the fields present in the request are changed. Re-checks the edited audience against the editor's authority. Returns the updated campaign.

Clones a campaign into a new draft under the same title, dropping any schedule. Returns the new campaign.

Uploads a campaign push image to the CDN and returns its public URL for the campaign's imageUrl/secondaryImageUrl fields.

Duplicates a finished campaign (sent/partially failed/failed/canceled) into a new campaign and immediately queues it for dispatch. The source campaign is left untouched. Returns the new campaign.

Queues an authored campaign for asynchronous fan-out. Returns the campaign.

Returns the notification-channel registry (key + name) for the campaign channel selector.

Mutes or unmutes MARKETING notifications from one followed cinema.

Lists the authenticated user's notification inbox, scoped to the request's channel.

Reads a single inbox item, scoped to the authenticated user and their channel.

Marks an inbox item read / received / clicked / deleted for the authenticated user.

Aggregates campaign/recipient/delivered/failed totals per tenant over a window.

Returns the authenticated user's marketing consent + per-cinema mutes for the request channel.

Sets the authenticated user's MARKETING opt-in for the request channel.

Renders a confirmation page (HTML). Does NOT mutate — a link prefetch must not unsubscribe. The confirmation form POSTs to commit.

Opts the token owner out of MARKETING notifications on every channel. Public, tokenized, idempotent. RFC 8058 List-Unsubscribe-Post one-click target.

Returns a list of notification messages objects.

Creates a notification message. Returns the created notification message.

Send MA NotificationMessage to User

Returns the requested notification message.

Send NotificationMessage

Unsubscribes a device from all topics. It returns the User object.

Subscribes a device to a cinema topic, to get notifications about everything related to that topic. It returns the User object.

Subscribes a device to a global topic, to get notifications about everything related to that topic. It returns the User object.

Sets notification-subscription and device for user. It returns the User object.