Delete a Special Notification
The Delete Notification endpoint permanently removes a specific notification from the Netevia banking system using its unique identifier. Once deleted, the notification is no longer accessible or visible to any users. This action is irreversible and cannot be undone.
Endpoint
DELETE /netevia/support/notifications/{id}
Authentication
Bearer token required. Obtain via:
POST https://api.banking.netevia.dev/api/auth/v2
Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.
When to use
Use this endpoint when a notification is outdated, erroneous, or no longer relevant and needs to be removed from the system. This is useful for support and administrative workflows that require cleanup of notification records. Because deletion is permanent and irreversible, confirm the correct notification ID before calling this endpoint.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer (int32) | Yes | The unique identifier of the notification to delete. |
Response
200 OK
A successful response indicates the notification was permanently deleted. No response body is returned.
Error Codes
| Code | When it happens |
|---|---|
| 400 | The provided id is not a valid integer or is malformed. |
| 401 | Token missing, expired, or invalid. |
| 403 | Insufficient permissions to delete notifications. |
| 404 | No notification found with the specified id. |
| 500 | Internal server error. |
Common Mistakes
- Providing a non-integer or negative value for
id— the field must be a valid int32 integer. - Attempting to delete an already-deleted notification — the endpoint will return 404 since the record no longer exists.
- Assuming the action is reversible — once deleted, the notification cannot be restored; verify the correct ID before calling this endpoint.
Related Endpoints
GET /netevia/support/notifications— Retrieve a list of all notifications.GET /netevia/support/notifications/{id}— Retrieve details of a specific notification by ID.
Example
curl -X DELETE https://api.banking.netevia.dev/netevia/support/notifications/42 \
-H "Authorization: Bearer YOUR_TOKEN" 200Success
