Update an existing schedule item

PUT

/api/managing-entity/{managingEntityIdentifier}/extranet/schedule/{inventoryIdentifier}/item/{identifier}

const 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';
const options = {
  method: 'PUT',
  headers: {
    'Wink-Version': '2.0',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: 'null'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request PUT \
  --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 'Content-Type: application/json' \
  --header 'Wink-Version: 2.0' \
  --data null

Updates an existing calendar item identified by its identifier on a piece of inventory. Allows modifying the event timing, timezone, and attendee count. Returns the updated item.

Authorizations

oauth2ClientCredentials

Parameters

Path Parameters

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 update

Example

9c2e7f1a-4b8d-4e3c-a5f6-2d9b1e0c7a43

identifier

required

string

Identifier of the schedule item to update

Example

b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47

Header Parameters

Wink-Version

string

default: 2.0.0

Allowed values: 2.0

Request Body^required

Updated schedule item details including revised start and end times, timezone, and attendee count

application/json

Request body for updating the timing, timezone, and attendee count of an existing schedule item.

object

attendees

required

Number of guests or attendees for this event. Must be at least 1.

integer format: int32

default: 1 >= 1

Example

end

required

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

string format: date-time

Example

2026-02-15T15:30:00

endTimezone

required

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

string

"" >= 1 characters

Example

Asia/Bangkok

isAllDay

required

Flag indicating whether this is an all-day event (no specific time). If true, time portions of start and end are ignored.

boolean

Example

true

start

required

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

string format: date-time

Example

2026-02-15T14:00:00

startTimezone

required

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

string

"" >= 1 characters

Example

Asia/Bangkok

Example

{
  "attendees": 2,
  "end": "2026-02-15T15:30:00",
  "endTimezone": "Asia/Bangkok",
  "isAllDay": true,
  "start": "2026-02-15T14:00:00",
  "startTimezone": "Asia/Bangkok"
}

Responses

200

Schedule item updated successfully

application/json

Lightweight projection of a calendar schedule item representing a reservation or event on a travel inventory such as a meeting room, restaurant, spa, activity, attraction, or place.

object

address

Venue address

object

address1

Address line 1

string

address2

Address line 2

string

city

City name

string

country

Country

string

countryCode

Country

string

"" /^[A-Z]{2}$/

county

County

string

fullAddress

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

string

postalCode

Postal / zip code

string

state

State

string

allDay

boolean

attendees

Number of guests attending this event.

integer format: int32

default: 1

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

brandName

Brand name to display in event notification emails and headers.

string

contact

Venue contact person

object

email

Contact E-mail

string format: email

firstName

Contact first name

string

fullName

First and last name

string

lastName

Contact last name

string

phoneNumber

Contact phone number

string

"" /^\+?[1-9]\d{1,14}$/

secondaryEmail

Contact secondary Email

string format: email

summary

Summary

string

created

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

string format: date-time

createdDate

Datetime this record was first created

string | null format: date-time

description

Description of scheduled event.

string

email

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

string format: email

emailHeaderLogoUrl

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

string format: uri

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

firstName

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

string

fullName

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

string

hotelIdentifier

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

string format: uuid

Unique identifier for this record.

string format: uuid

isAllDay

Flag indicating whether this is an all day event.

boolean

language

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

string

"" /^[a-z]{2}(-[A-Z]{2})?$/

lastModified

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

string format: date-time

lastName

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

string

lastUpdate

Datetime this record was last updated

string | null format: date-time

localizedVenueName

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

string

logoIdentifier

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

string

ownerIdentifier

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

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>

recurrenceId

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

string format: uuid

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

sequence

Schedule event recurring sequence

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

title

Title of scheduled event.

string

type

The type of travel inventory.

string

Allowed values: ROOM_TYPE_ANCILLARY ADD_ON MEETING_ROOM SPA RESTAURANT ACTIVITY ATTRACTION PLACE

venueName

Name of the venue where the scheduled event takes place.

string

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

key

additional properties

Example

{
  "address": {
    "address1": "234 Near da beach",
    "address2": "Pebble #5001",
    "city": "Bangkok",
    "country": "United States",
    "countryCode": "TH",
    "county": "Alameda county",
    "fullAddress": "11 At home, Suite 3C, New York City, NY 10010, United States",
    "postalCode": "90210",
    "state": "CA"
  },
  "attendees": 2,
  "bookingIdentifier": "f4d1c8e5-2b9a-4f3d-9e7c-1b6a5d3f8c92",
  "bookingOwnerIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69",
  "brandName": "The Siam Residences",
  "contact": {
    "email": "[email protected]",
    "firstName": "Alexandra",
    "fullName": "Alexandra Beaumont",
    "lastName": "Beaumont",
    "phoneNumber": "+12125551212",
    "secondaryEmail": "[email protected]",
    "summary": "John Smith ([email protected] / +12125551212)"
  },
  "created": "2026-01-14T09:30:00",
  "createdDate": "2026-01-14T09:30:00",
  "description": "Reservation for Jane Doe - 2 PAX",
  "email": "[email protected]",
  "emailHeaderLogoUrl": "https://res.cloudinary.com/wink/image/upload/v1/branding/the-siam-residences-logo.png",
  "end": "2026-02-15T15:30:00",
  "endTimezone": "Asia/Bangkok",
  "firstName": "Alexandra",
  "fullName": "Alexandra Beaumont",
  "hotelIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18",
  "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47",
  "isAllDay": true,
  "language": "en",
  "lastModified": "2026-02-03T16:45:12",
  "lastName": "Beaumont",
  "lastUpdate": "2026-02-03T16:45:12",
  "localizedVenueName": "ห้องอาหารหลัก",
  "logoIdentifier": "the-siam-residences-logo",
  "ownerIdentifier": "9c2e7f1a-4b8d-4e3c-a5f6-2d9b1e0c7a43",
  "recurrenceException": [
    "2026-02-16T14:00:00",
    "2026-02-18T14:00:00"
  ],
  "recurrenceId": "a2d5f8b1-1c4e-4d7a-8b3f-2e9a0c6b5d41",
  "recurrenceRule": "FREQ=DAILY;COUNT=5",
  "sequence": 0,
  "start": "2026-02-15T14:00:00",
  "startTimezone": "Asia/Bangkok",
  "title": "Jane Doe +1",
  "type": "MEETING_ROOM",
  "venueName": "The Siam Residences Dining Hall",
  "version": 3
}

400

Bad Request — missing or invalid request parameter or body

application/problem+json

object

detail

string

instance

string format: uri

properties

object

key

additional properties

status

integer format: int32

title

string

type

string format: uri

key

additional properties

Example

401

Unauthorized — authentication is required or the session has expired

application/problem+json

object

detail

string

instance

string format: uri

properties

object

key

additional properties

status

integer format: int32

title

string

type

string format: uri

key

additional properties

Example

403

Forbidden — authenticated but lacking the required permission or scope

application/problem+json

object

detail

string

instance

string format: uri

properties

object

key

additional properties

status

integer format: int32

title

string

type

string format: uri

key

additional properties

Example

404

Not Found — the requested resource does not exist

application/problem+json

object

detail

string

instance

string format: uri

properties

object

key

additional properties

status

integer format: int32

title

string

type

string format: uri

key

additional properties

Example

405

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

application/problem+json

object

detail

string

instance

string format: uri

properties

object

key

additional properties

status

integer format: int32

title

string

type

string format: uri

key

additional properties

Example

409

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

application/problem+json

object

detail

string

instance

string format: uri

properties

object

key

additional properties

status

integer format: int32

title

string

type

string format: uri

key

additional properties

Example

415

Unsupported Media Type — use application/json

application/problem+json

object

detail

string

instance

string format: uri

properties

object

key

additional properties

status

integer format: int32

title

string

type

string format: uri

key

additional properties

Example

500

Internal Server Error — an unexpected failure occurred on the server

application/problem+json

object

detail

string

instance

string format: uri

properties

object

key

additional properties

status

integer format: int32

title

string

type

string format: uri

key

additional properties

Example

503

Service Unavailable — a downstream dependency is unreachable

application/problem+json

object

detail

string

instance

string format: uri

properties

object

key

additional properties

status

integer format: int32

title

string

type

string format: uri

key

additional properties

Update an existing schedule item

Authorizations

Parameters

Path Parameters

Example

Example

Example

Header Parameters

Request Bodyrequired

Example

Example

Example

Example

Example

Example

Example

Responses

200

Example

400

Example

401

Example

403

Example

404

Example

405

Example

409

Example

415

Example

500

Example

503

Example

Request Body^required