Delete a notification

Deletes one of the connected account's own notification cards by its card urn. This is a self-action, no third party is notified. It cannot be undone. Pass the card_urn of a notifications list item (not object_urn).

delete/v1/{account_id}/notifications/{card_urn}

Request

Base URL: https://api.curviate.com
URL: https://api.curviate.com/v1/{account_id}/notifications/{card_urn}
Auth: HTTP bearer

Path parameters

account_idstring required

The connected LinkedIn account whose notifications to read or act on.

card_urnstring required

The card_urn field of a notifications list item (not object_urn). Percent-encode it into the path. This cannot be undone.

Response

The notification card was deleted. This cannot be undone.

Safe to retry. Deleting a card you already deleted succeeds with 200 again, it is not an error, and it does not delete anything else. A client that retries after a network timeout is never punished for it. (A card_urn that never existed on this account is a 404; that distinguishes a wrong handle from a repeat.)

Timing. The removal takes effect within a few seconds; a notifications list read immediately after this call may still include the card for a moment. If you need to confirm removal, re-read after a short delay rather than instantly; but the 200 is already your confirmation that the card was resolved and the removal accepted.

object'notification_deleted' required

Response type discriminator.

card_urnstring required

The card urn that was deleted.

Example response

{
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

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