Replace Push Notifications You Already Sent

Push Notifications you already sent can now be replaced with a new one. Use it to update a notification when the situation changes, for example when an incident you alerted on is resolved.

Replace a Push Notification

Every Push Notification you send returns a notification_id. Pass it to replace with the new content.

1
const sent = await activitysmith.notifications.send({
2
  title: "🚨 checkout-api is down",
3
  message: "500 errors on 62% of requests.",
4
});
5
6
await activitysmith.notifications.replace(sent.notification_id, {
7
  title: "✅ checkout-api recovered",
8
  message: "Error rate is back to normal.",
9
});

The new notification takes the old one's place on your Lock Screen and in Notification Center, so you don't end up with two. It arrives silently, without sound or lighting up the screen, and goes to the same devices as the original. Your notification history shows the latest version.

Availability

Available through the API, SDKs version 1.14.0 and newer, the CLI, and the MCP server.