Skip to content

Delete a schedule item

DELETE
/api/managing-entity/{managingEntityIdentifier}/extranet/schedule/{inventoryIdentifier}/item/{identifier}
curl --request DELETE \
--url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/extranet/schedule/9c2e7f1a-4b8d-4e3c-a5f6-2d9b1e0c7a43/item/b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47 \
--header 'Authorization: Bearer <token>' \
--header 'Wink-Version: 2.0'

Removes a calendar item identified by its identifier from the inventory’s schedule. The operation is permanent and cannot be undone. Returns the deleted item.

managingEntityIdentifier
required
string
""

Identifier of the managing entity (property/company) that owns the inventory

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

Identifier of the travel inventory containing the schedule item to delete

Example
9c2e7f1a-4b8d-4e3c-a5f6-2d9b1e0c7a43
identifier
required
string
""

Identifier of the schedule item to delete

Example
b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Schedule item deleted successfully

Media type application/json
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
""
start

Start date and time of scheduled event in ISO-8601 format.

string format: date-time
""
startTimezone

Timezone identifier for the start time, using IANA time zone database format (e.g., Asia/Bangkok, America/New_York).

string
""
end

End date and time of scheduled event in ISO-8601 format.

string format: date-time
""
endTimezone

Timezone identifier for the end time, using IANA time zone database format (e.g., Asia/Bangkok, America/New_York).

string
""
isAllDay

Flag indicating whether this is an all day event.

boolean
title

Title of scheduled event.

string
""
description

Description of scheduled event.

string
""
recurrenceRule

Recurrence rule in iCalendar format (RFC 5545). If present, indicates this is a recurring event. Null for non-recurring events. For details see iCalendar specification.

string
""
recurrenceId

Identifier of the parent recurring event. Used when this instance is part of a recurring series.

string format: uuid
""
recurrenceException

List of date-times that are exceptions to the recurrence rule (dates when the recurring event does not occur).

Array<string>
""
ownerIdentifier

Unique identifier of the travel inventory (meeting room, restaurant, spa, activity, etc.) that owns this schedule item.

string format: uuid
""
bookingIdentifier

Booking identifier that this scheduled event is associated with.

string format: uuid
""
bookingOwnerIdentifier

Identifier of the managing entity (company/organization) that owns this schedule item.

string format: uuid
""
hotelIdentifier

Identifier of the property (hotel) that owns the travel inventory.

string format: uuid
""
type

The type of travel inventory.

string
""
Allowed values: ROOM_TYPE_ANCILLARY ADD_ON MEETING_ROOM SPA RESTAURANT ACTIVITY ATTRACTION PLACE
attendees

Number of guests attending this event.

integer format: int32
default: 1 >= 1
email
required

Email address of the person who scheduled or is managing this event.

string format: email
"" >= 1 characters
fullName

Full name of the person who scheduled or is managing this event.

string
""
firstName

First name of the person who scheduled or is managing this event.

string
""
lastName

Last name of the person who scheduled or is managing this event.

string
""
venueName

Name of the venue where the scheduled event takes place.

string
""
localizedVenueName

Localized (translated) name of the venue in the local language.

string
""
contact

Venue contact person

object
firstName

Contact first name

string
""
lastName

Contact last name

string
""
email

Contact E-mail

string format: email
""
secondaryEmail

Contact secondary Email

string
""
phoneNumber

Contact phone number

string
""
fullName

First and last name

string
""
summary

Summary

string
""
address

Venue address

object
address1

Address line 1

string
""
address2

Address line 2

string
""
state

State

string
""
postalCode

Postal / zip code

string
""
county

County

string
""
city

City name

string
""
countryCode

Country

string
""
country

Country

string
""
fullAddress

Address 1, Address 2, City, State, Postal / Zip code, Country

string
""
created

Timestamp when this schedule item was created, in ISO-8601 format.

string format: date-time
""
lastModified

Timestamp when this schedule item was last modified, in ISO-8601 format.

string format: date-time
""
sequence

Schedule event recurring sequence

integer format: int64
0
brandName

Brand name to display in event notification emails and headers.

string
""
emailHeaderLogoUrl

URL of the logo image to display in event notification email headers. Typically a Cloudinary CDN URL.

string format: uri
""
logoIdentifier

Cloudinary identifier for the logo image, used for referencing and potential reuse across notifications.

string
""
language

ISO 639-1 language code for the user’s preferred language in notifications (e.g., en, th, de).

string
""
allDay
boolean
key
additional properties
""
Example

Bad Request

object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
Example generated
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"instance": "https://example.com",
"properties": {
"additionalProperty": "example"
}
}

Authentication failed or missing

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

Insufficient permissions to delete schedules for this inventory

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

Schedule item, inventory, or managing entity not found

Media type application/json
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
""
start

Start date and time of scheduled event in ISO-8601 format.

string format: date-time
""
startTimezone

Timezone identifier for the start time, using IANA time zone database format (e.g., Asia/Bangkok, America/New_York).

string
""
end

End date and time of scheduled event in ISO-8601 format.

string format: date-time
""
endTimezone

Timezone identifier for the end time, using IANA time zone database format (e.g., Asia/Bangkok, America/New_York).

string
""
isAllDay

Flag indicating whether this is an all day event.

boolean
title

Title of scheduled event.

string
""
description

Description of scheduled event.

string
""
recurrenceRule

Recurrence rule in iCalendar format (RFC 5545). If present, indicates this is a recurring event. Null for non-recurring events. For details see iCalendar specification.

string
""
recurrenceId

Identifier of the parent recurring event. Used when this instance is part of a recurring series.

string format: uuid
""
recurrenceException

List of date-times that are exceptions to the recurrence rule (dates when the recurring event does not occur).

Array<string>
""
ownerIdentifier

Unique identifier of the travel inventory (meeting room, restaurant, spa, activity, etc.) that owns this schedule item.

string format: uuid
""
bookingIdentifier

Booking identifier that this scheduled event is associated with.

string format: uuid
""
bookingOwnerIdentifier

Identifier of the managing entity (company/organization) that owns this schedule item.

string format: uuid
""
hotelIdentifier

Identifier of the property (hotel) that owns the travel inventory.

string format: uuid
""
type

The type of travel inventory.

string
""
Allowed values: ROOM_TYPE_ANCILLARY ADD_ON MEETING_ROOM SPA RESTAURANT ACTIVITY ATTRACTION PLACE
attendees

Number of guests attending this event.

integer format: int32
default: 1 >= 1
email
required

Email address of the person who scheduled or is managing this event.

string format: email
"" >= 1 characters
fullName

Full name of the person who scheduled or is managing this event.

string
""
firstName

First name of the person who scheduled or is managing this event.

string
""
lastName

Last name of the person who scheduled or is managing this event.

string
""
venueName

Name of the venue where the scheduled event takes place.

string
""
localizedVenueName

Localized (translated) name of the venue in the local language.

string
""
contact

Venue contact person

object
firstName

Contact first name

string
""
lastName

Contact last name

string
""
email

Contact E-mail

string format: email
""
secondaryEmail

Contact secondary Email

string
""
phoneNumber

Contact phone number

string
""
fullName

First and last name

string
""
summary

Summary

string
""
address

Venue address

object
address1

Address line 1

string
""
address2

Address line 2

string
""
state

State

string
""
postalCode

Postal / zip code

string
""
county

County

string
""
city

City name

string
""
countryCode

Country

string
""
country

Country

string
""
fullAddress

Address 1, Address 2, City, State, Postal / Zip code, Country

string
""
created

Timestamp when this schedule item was created, in ISO-8601 format.

string format: date-time
""
lastModified

Timestamp when this schedule item was last modified, in ISO-8601 format.

string format: date-time
""
sequence

Schedule event recurring sequence

integer format: int64
0
brandName

Brand name to display in event notification emails and headers.

string
""
emailHeaderLogoUrl

URL of the logo image to display in event notification email headers. Typically a Cloudinary CDN URL.

string format: uri
""
logoIdentifier

Cloudinary identifier for the logo image, used for referencing and potential reuse across notifications.

string
""
language

ISO 639-1 language code for the user’s preferred language in notifications (e.g., en, th, de).

string
""
allDay
boolean
Example
{
"id": "",
"createdDate": "",
"lastUpdate": "",
"version": "",
"start": "",
"startTimezone": "",
"end": "",
"endTimezone": "",
"isAllDay": false,
"title": "",
"description": "",
"recurrenceRule": "",
"recurrenceId": "",
"recurrenceException": "",
"ownerIdentifier": "",
"bookingIdentifier": "",
"bookingOwnerIdentifier": "",
"hotelIdentifier": "",
"type": "ROOM_TYPE_ANCILLARY",
"attendees": 1,
"email": "",
"fullName": "",
"firstName": "",
"lastName": "",
"venueName": "",
"localizedVenueName": "",
"contact": "",
"address": null,
"created": "",
"lastModified": "",
"sequence": 0,
"brandName": "",
"emailHeaderLogoUrl": "",
"logoIdentifier": "",
"language": ""
}

Internal Server Error

object
Example generated
{}