Skip to content
Wink

Delete

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

Permanently remove a single notification by its identifier.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
messageIdentifier
required
string
""

Message identifier to be removed

Example
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51

Header Parameters

Section titled “Header Parameters”
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Responses

Section titled “Responses”

200

Section titled “200”

Notification deleted successfully

Media typeapplication/json

Lightweight projection of a notification used for listing and display purposes

object
id

Unique identifier for this record.

string format: uuid
""
createdDate

Datetime this record was first created

string | null format: date-time
""
lastUpdate

Datetime this record was last updated

string | null format: date-time
""
version

Optimistic-locking version. Echo this value back as an If-Match request header on a conditional update; the server responds 409 if the record changed in the meantime. Null when this projection has no backing versioned document, in which case no conditional update is possible.

integer | null format: int64
""
userIdentifier
required

Owner identifier

string format: uuid
"" >= 1 characters
managingEntityIdentifier

Managing entity 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 identifier

string
"" >= 1 characters
subject
required

Subject of message

string
"" >= 1 characters
body
required

Body of message

string
"" >= 1 characters
ctaUrl

Call-to-action URL path to a related feature

string format: uri
""
read
required

Whether the recipient has read this notification

boolean
markedAsRemoved
required

Whether this notification has been soft-deleted

boolean
notifyViaEmail
required

Whether to also deliver this notification via email

boolean
key
additional properties
""
Example
{
  "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47",
  "createdDate": "2026-01-14T09:30:00",
  "lastUpdate": "2026-02-03T16:45:12",
  "version": 3,
  "userIdentifier": "c3a9f2e1-8b4d-4c7a-a1e2-5f0b6d9e2c84",
  "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
}

400

Section titled “400”

Bad Request — missing or invalid request parameter or body

Media typeapplication/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

401

Section titled “401”

Unauthorized — authentication is required or the session has expired

Media typeapplication/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

403

Section titled “403”

Forbidden — authenticated but lacking the required permission or scope

Media typeapplication/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

404

Section titled “404”

Not Found — the requested resource does not exist

Media typeapplication/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

405

Section titled “405”

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

Media typeapplication/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

409

Section titled “409”

Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version

Media typeapplication/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

415

Section titled “415”

Unsupported Media Type — use application/json

Media typeapplication/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

500

Section titled “500”

Internal Server Error — an unexpected failure occurred on the server

Media typeapplication/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

503

Section titled “503”

Service Unavailable — a downstream dependency is unreachable

Media typeapplication/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