Skip to main content
POST
Unsend a Notification
Tells every device that confirmed receipt of a notification to remove it from its notification tray, using a silent follow-up push. Only valid for notifications with status sent — one that’s scheduled was never delivered (use Cancel a scheduled notification instead), and failed/canceled/unsent ones have nothing left on a device to remove. The notification stays in your history; its status becomes unsent. This only reaches out to the device — it never deletes anything from history.
See the API introduction to set up your base URL and private key before making requests.
This requires the recipient’s app to be running a client SDK version that supports unsend (it needs the notification-removal handler wired into AppDelegate.swift on iOS). Devices on an older app version can’t have a notification recalled, no matter what this endpoint does server-side.

Parameters

string
required
Your project ID from Project Settings in the dashboard.
string
required
The notificationId returned when the notification was sent.
string
Deprecated alternative to the lerix-key header, still accepted.

Response

201 Created
On failure, the response follows the shape documented in Error & success codes.