Skip to content

DELETE/notifications/{id}

Delete notification

Permanently remove a notification. Returns deleted resource. Triggers `notifications.deleted` webhook.

Parameters 1

NameTypeDescription
idrequiredpath · integerResource identifier

ReturnsNotification

Bearer token required

Response examples

200Deleted notification

application/json example derived from schema

{
  "id": 1,
  "userId": 1,
  "type": "error",
  "title": "Error notification",
  "message": "New follower on your profile.",
  "read": true,
  "link": null,
  "createdAt": "2026-03-23T15:22:15.402Z"
}
404404 — resource not found

application/json

{
  "error": {
    "status": 404,
    "message": "users #999 not found"
  }
}

Released under the MIT License.