Skip to content

Delete for account

DELETE
/api/managing-entity/{managingEntityIdentifier}/message/{messageIdentifier}
curl --request DELETE \
--url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/message/3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51 \
--header 'Authorization: Bearer <token>' \
--header 'Wink-Version: 2.0'

Permanently remove a notification belonging to the given managing entity by its identifier.

managingEntityIdentifier
required
string
""

Managing entity identifier

Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69
messageIdentifier
required
string
""

Message identifier to be removed

Example
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Notification deleted successfully

Media type application/json

A notification message delivered to a user or managing entity within the Wink platform

object
id

Document UUID

string format: uuid
""
createdDate

Datetime this record was first created

string format: date-time
""
lastUpdate

Datetime this record was last updated

string format: date-time
""
version

Version property that shows how many times this document has been persisted. Document will not persist if the version property is less than current version property in the system. Result in an optimistic locking exception.

integer format: int64
""
userIdentifier
required

Owner identifier

string format: uuid
"" >= 1 characters
managingEntityIdentifier

ManagingEntity identifier

string format: uuid
""
name

Owner name

string
""
priority
required

Importance of message

string
""
Allowed values: HIGH MEDIUM LOW
type
required

Message type

string
""
Allowed values: ALERT MESSAGE FEATURE
recipientType
required

Recipient type

string
""
Allowed values: USER ACCOUNT
messageTemplateId
required

Message template

string
"" >= 1 characters
subject
required

Subject of message

string
"" >= 1 characters
body
required

Body of message

string
"" >= 1 characters
ctaUrl

Path to feature

string format: uri
""
read

AffiliateAccount read announcement

boolean
markedAsRemoved

Message marked as removed

boolean
notifyViaEmail

Also send email announcement

boolean
key
additional properties
""
Example
{
"id": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51",
"createdDate": "2026-01-14T09:30:00",
"lastUpdate": "2026-01-14T09:30:00",
"version": 0,
"userIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69",
"managingEntityIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69",
"name": "The Siam Residences, Bangkok",
"priority": "MEDIUM",
"type": "MESSAGE",
"recipientType": "ACCOUNT",
"messageTemplateId": "welcome-email-2024",
"subject": "Your Booking Confirmation",
"body": "Your booking at The Siam Residences for January 14-16, 2026 has been confirmed.",
"ctaUrl": "https://app.wink.travel/bookings/WNK4ZQ7P",
"read": false,
"markedAsRemoved": false,
"notifyViaEmail": false
}

Bad Request — missing or invalid request parameter or body

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Unauthorized — authentication is required or the session has expired

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Forbidden — authenticated but lacking the required permission or scope

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Not Found — the requested resource does not exist

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Method Not Allowed — the HTTP verb is not supported on this endpoint

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Unsupported Media Type — use application/json

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Internal Server Error — an unexpected failure occurred on the server

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

Service Unavailable — a downstream dependency is unreachable

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example