notifications

Dismiss notification

Dismiss a notification (a soft-delete, the audit row stays; a delivery in flight is not canceled). An in_app row only by its recipient (403 not_the_notification_recipient). Idempotent.

Contract:

  • MCP tool delete_notification, registry package mcp.id/notifications, mount id.notifications.
  • Operation delete, response envelope delete_simple.
  • Flags: dangerous: the MCP layer gates it behind a preview/commit token, and the effect cannot be undone through this API.
delete/api/notifications/{sid}

Request

  • Base URL
    https://beta.getsales.io/id/v1
  • Auth
    HTTP bearer and API key in header Team-SID

Path parameters

sidstring required

The id_nt_* sid of the row to delete.

Response

delete_simple success envelope.

successtrue required
operation'delete' required
itemobject required
already_deletedboolean required
soft_deletedboolean required
retainedstring[] required

Changes

No recorded changes to this operation across all 1 revision of this API.