Delete Notification

Deletes a specific notification by its unique identifier. Use this endpoint to remove notifications that are no longer needed or relevant for the user.

HTTP Method and URL

Method: DELETE
URL: {{host}}/notifications/:notification_id

Authentication Requirements

Requires a valid user authentication token.
Header: user-token:

Path and Query Parameters

• notification_id (string, required): The unique identifier of the notification to delete. This is provided as a path parameter in the URL.

Example Request

DELETE {{host}}/notifications/12345
user-token: <your_token>

Example Successful Response

{
  "success": true,
  "message": "Notification deleted successfully."
}

Error Responses

• 401 Unauthorized: Missing or invalid authentication token.

• 404 Not Found: Notification with the specified ID does not exist.

• 500 Internal Server Error: An unexpected error occurred on the server.

Usage Notes

• Ensure the notification_id exists and belongs to the authenticated user.

• This operation is irreversible; deleted notifications cannot be recovered.