Skip to content

Copy item

POST
/api/managing-entity/{managingEntityIdentifier}/studio/static-list/{listIdentifier}/item/{itemIdentifier}
curl --request POST \
--url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/studio/static-list/b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47/item/3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Wink-Version: 2.0' \
--data null

Duplicate an item into a target list, leaving the original item in place.

managingEntityIdentifier
required
string
""

Copy inventory to curated list owned by this owner identifier.

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

List identifier.

Example
b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47
itemIdentifier
required
string
""

Item identifier.

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

Target list identifier into which the item should be copied while leaving the original in place

Media typeapplication/json

Request to copy or move a list item to a target curated list.

object
targetListIdentifier
required

Target list identifier to copy or move the item to.

string format: uuid
""
Example
b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47
Example
{
"targetListIdentifier": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47"
}

Newly created copy of the list item in the target list

Media typeapplication/json

A single travel inventory entry within a curated list, linking a sales channel inventory item to its parent list.

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
""
parent
required

Parent list

object
id
required

Unique identifier for this record.

string format: uuid
"" >= 1 characters
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
""
ownerIdentifier
required

List creator

string format: uuid
"" >= 1 characters
name
required

Name of curated list

string
"" >= 1 characters
type
required

Every affiliate starts out with a Favorite list. All other lists will be of type NORMAL

string
""
Allowed values: FAVORITE NORMAL
createdDate

Datetime this record was first created

string | null format: date-time
""
lastUpdate

Datetime this record was last updated

string | null format: date-time
""
item
required

Channel inventory

object
identifier
required

Channel Inventory identifier

string format: uuid
""
salesChannel
required

Parent sales channel

object
id
string
supplierIdentifier
string
supplierName
string
subType

Type of entity that manages, facilitates, or administers properties, bookings, or payments on the Wink Platform

string
Allowed values: TRIP_PAY FACILITATOR DIRECT APPLICATION HOTEL TRAVELIKO CORPORATE TRAVEL_AGENT INFLUENCER BLOGGER DESTINATION CHANNEL_MANAGER PROPERTY_MANAGEMENT_SYSTEM CENTRAL_RESERVATION_SYSTEM GOOGLE_HOTEL_API MANAGEMENT_COMPANY CHAIN BRAND EVENT_ORGANIZER OTHER
ownerIdentifier
string
ownerName
string
enabled
boolean
channelDisabled
boolean
blacklisted
boolean
percentDiscount
number format: float
commission
number format: float
rateModifiers
Array<object>
object
id
string
hotelIdentifier
string
name
string
type

Determines whether a special rate reduces (DISCOUNT) or increases (PREMIUM) the base price.

string
Allowed values: PREMIUM DISCOUNT
modifier
enabled
boolean
pricingType

Pricing granularity that determines how a rate or fee is calculated and applied

string
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
descriptions
Array<object>

Simplified localized description containing text content and its language code.

object
description
required

Longer text description

string
"" >= 1 characters <= 2147483647 characters
language
required

Indicate which language this description is written in.

string
default: en >= 2 characters <= 2 characters /^[a-z]{2}(-[A-Z]{2})?$/
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
cityRateQualifiers
Array
continentRateQualifiers
Array
countryRateQualifiers
Array
promotionRateQualifiers
Array
ipRangeRateQualifiers
Array
roomRangeRateQualifier

Qualifier that restricts a promotion to bookings with a specified minimum and/or maximum number of rooms.

prepayRateQualifier

Qualifier that restricts a promotion to either prepaid or pay-at-property rates.

refundableRateQualifier

Qualifier that restricts a promotion to either refundable or non-refundable rates.

timezoneRateQualifiers
Array
lastMinuteRateQualifier

Qualifier that restricts a promotion to last-minute bookings made within a specified number of seconds before the stay start date.

lengthOfStayRateQualifier

Qualifier that restricts a promotion to stays within a specified minimum and maximum length of stay (in nights).

advanceBookingRateQualifier

Qualifier that restricts a promotion to bookings made within a specific advance window before the stay start date.

stayDateRateQualifiers
Array
sellDateRateQualifiers
Array
availableDaysOfWeekRateQualifier

Qualifier that restricts a promotion to specific days of the week when it is available for booking.

arrivalDaysOfWeekRateQualifier

Qualifier that restricts a promotion to guests arriving on specific days of the week.

departureDaysOfWeekRateQualifier

Qualifier that restricts a promotion to guests departing on specific days of the week.

requiredDaysOfWeekRateQualifier

Qualifier that restricts a promotion to stays that include specific required days of the week.

masterRateIdentifiers
Array<string>
addOnIdentifiers
Array<string>
ratePlanIdentifiers
Array<string>
blackoutDates
Array
rateModifierBundles
Array<object>
object
id
string
hotelIdentifier
string
name
string
enabled
boolean
items
Array<object>

A lightweight projection of a special rate (promotion) containing all qualifying conditions and metadata.

object
id
required

Unique identifier for this record.

string format: uuid
"" >= 1 characters
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
""
hotelIdentifier
required

Unique identifier of the property this promotion belongs to.

string format: uuid
"" >= 1 characters
name
required

Internal name of promotion.

string
"" >= 1 characters
type
required

Set whether you want the price to go up or down when the rules of this promotion have been satisfied.

string
""
Allowed values: PREMIUM DISCOUNT
modifier
required

The discount or premium amount and its type (fixed or percentage).

""
enabled
required

Whether this promotion is enabled or not.

boolean
default: true
pricingType
required

This determines whether this discount should be applied per night, per stay or per person - per night

string
""
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
descriptions
required
Array<object>
>= 1 items

Simplified localized description containing text content and its language code.

object
description
required

Longer text description

string
"" >= 1 characters <= 2147483647 characters
language
required

Indicate which language this description is written in.

string
default: en >= 2 characters <= 2 characters /^[a-z]{2}(-[A-Z]{2})?$/
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
cityRateQualifiers
Array<object>

Qualifier that restricts a promotion to guests whose IP geolocation resolves to a specific city.

object
city
required

City details (obtained via geonames) to restrict the promotion by guest location.

object
geoNameId
required

GeoNameLightweight identifiers taken from https://geonames.org.

string
"" >= 1 characters
localeCode
required

Locale code

string
"" >= 1 characters /^[a-z]{2}(-[A-Z]{2})?$/
continentCode
required

Continent code

string
"" >= 1 characters
continentName
required

Continent name

string
"" >= 1 characters
countryIsoCode
required

Country ISO code

string
"" >= 1 characters /^[A-Z]{2}$/
countryName
required

Country name

string
"" >= 1 characters
cityName
required

City name

string
"" >= 1 characters
timezone
required

Timezone

string
"" >= 1 characters
subDivision1Code

Sub-division 1 code

string
""
subDivision1Name

Sub-division 1 name

string
""
subDivision2Code

Sub-division 2 code

string
""
subDivision2Name

Sub-division 2 name

string
""
continentRateQualifiers
Array<object>

Qualifier that restricts a promotion to guests whose IP geolocation resolves to a specific continent.

object
continent
required

Two-letter continent code (e.g. NA, EU, AS)

string
"" >= 1 characters
countryRateQualifiers
Array<object>

Qualifier that restricts a promotion to guests whose IP geolocation resolves to a specific country.

object
country
required

Country (obtained via geonames) to restrict the promotion by guest location.

object
geoNameId

GeoNames identifier

string
""
continentCode

Continent code (two-letter ISO)

string
""
continentName

Continent name

string
""
countryIsoCode

Country ISO 3166-1 alpha-2 code

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

Country name

string
""
promotionRateQualifiers
Array<object>

Qualifier that restricts a promotion to guests who enter a specific promotional code at checkout.

object
promotion
required

Promo code that guests must enter to access this promotion.

string
"" >= 1 characters
ipRangeRateQualifiers
Array<object>

Qualifier that restricts a promotion to guests whose IP address falls within a specified IPv4 range.

object
startIPRange
required

Starting IP address of the range (inclusive).

string
"" >= 1 characters
endIPRange
required

Ending IP address of the range (inclusive).

string
"" >= 1 characters
roomRangeRateQualifier

Restrict promotion by restricting to how many rooms the user wants.

prepayRateQualifier

Restrict promotion to either prepaid / non-prepaid rates.

refundableRateQualifier

Restrict promotion to either refundable / non-refundable rates.

timezoneRateQualifiers
Array<object>

Qualifier that restricts a promotion to guests whose system timezone matches the specified IANA timezone name.

object
timezone
required

IANA timezone name of the booker’s location (e.g. Asia/Bangkok).

string
"" >= 1 characters
lastMinuteRateQualifier

Restrict promotion to users who want to book a room close to the date.

lengthOfStayRateQualifier

Restrict promotion to users who want to stay a certain number of days.

advanceBookingRateQualifier

Restrict promotion to users who want to book in advance.

stayDateRateQualifiers
Array<object>

Rate qualifier that restricts a promotion to guests whose stay falls within a specific date range.

object
effectiveDate
required

Promotion applies when guest’s stay starts on or after this date (inclusive).

string format: date
""
expireDate
required

Promotion applies when guest’s stay starts on or before this date (inclusive).

string format: date
""
sellDateRateQualifiers
Array<object>

Qualifier that restricts a promotion to bookings made within a specific date window.

object
effectiveDate
required

Promotion is available when the booking is made on or after this date (inclusive).

string format: date
""
expireDate
required

Promotion is available when the booking is made on or before this date (inclusive).

string format: date
""
availableDaysOfWeekRateQualifier

Restrict promotion to specific days of the week the promotion is available.

arrivalDaysOfWeekRateQualifier

Restrict promotion to specific days of the week the guest is arriving.

departureDaysOfWeekRateQualifier

Restrict promotion to specific days of the week the guest is departing.

requiredDaysOfWeekRateQualifier

Restrict promotion to specific days of the week the guest has to stay.

masterRateIdentifiers
Array<string>
addOnIdentifiers
Array<string>
ratePlanIdentifiers
Array<string>
blackoutDates
Array<object>

A date range during which a promotion is not available (blackout period).

object
effectiveDate
required

Start date when the promotion is not available (inclusive).

string format: date
""
expireDate
required

End date when the promotion is not available (inclusive).

string format: date
""
createdDate

Datetime this record was first created

string | null format: date-time
""
lastUpdate

Datetime this record was last updated

string | null format: date-time
""
modifierOverride
type

Determines whether a special rate reduces (DISCOUNT) or increases (PREMIUM) the base price.

string
Allowed values: PREMIUM DISCOUNT
pricingType

Pricing granularity that determines how a rate or fee is calculated and applied

string
Allowed values: PER_STAY PER_DAY PER_NIGHT PER_USE PER_HOUR PER_PERSON PER_PERSON_PER_NIGHT PER_PERSON_PER_HOUR PER_ADULT PER_ADULT_PER_NIGHT PER_ADULT_PER_HOUR PER_CHILD PER_CHILD_PER_NIGHT PER_CHILD_PER_HOUR
descriptions
Array<object>

Simplified localized description containing text content and its language code.

object
description
required

Longer text description

string
"" >= 1 characters <= 2147483647 characters
language
required

Indicate which language this description is written in.

string
default: en >= 2 characters <= 2 characters /^[a-z]{2}(-[A-Z]{2})?$/
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
selfAcquires
boolean
inventoryType
required

Inventory type

string
""
Allowed values: GUEST_ROOM ADD_ON MEETING_ROOM RESTAURANT SPA ATTRACTION PLACE ACTIVITY
inventoryIdentifier
required

Inventory type identifier

string format: uuid
"" >= 1 characters
inventoryNameInEnglish
required

Name of inventory as traveler is seeing it

string
"" >= 1 characters
enabled
required

Whether this inventory is enabled or not

boolean
default: true
image
required

Main image of inventory

object
multimediaIdentifier
required

Document identifier

string format: uuid
"" >= 1 characters
identifier
required

Use this identifier to communicate with Cloudinary.

string
"" >= 1 characters
type
required

Whether Cloudinary media is a VIDEO or IMAGE.

string
""
Allowed values: IMAGE VIDEO AUDIO RAW
source
required

Currently ONLY using Cloudinary to store all image / video assets.

string
default: CLOUDINARY
Allowed values: YOUTUBE CLOUDINARY
sort
required

Sort allows you to control how you want to sort this record in a list of media records.

integer format: int32
default: 999
angle

Media angle

string
""
width
required

Media width in pixels.

integer format: int32
"" >= 1
height
required

Media height in pixels.

integer format: int32
"" >= 1
published

Instead of deleting the media, choose to un-publish it instead for later re-use. Could be you keep seasonal images of the property.

boolean
category

Supported OTA specification PIC code. See OTA geoname data

string
""
descriptions

Localized media captions to give user some context about where this media was taken.

Array<object>
""

Foundation class for storing multi-language content (names and descriptions) with content change detection throughout the Wink Platform.

object
name
required

Use as title or short text description

string
""
description
required

Longer text description

string
"" >= 1 characters <= 2147483647 characters
language
required

Indicate which language this description is written in.

string
default: en >= 2 characters <= 2 characters /^[a-z]{2}(-[A-Z]{2})?$/
creator

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
md5ContentHash

The md5 hash of the name, description and language.

string
""
hashMismatch
boolean
lifestyleType

Associate this media with a specific lifestyle type. A user searching and filtering inventory based on lifestyles can be shown relevant media first.

string
""
Allowed values: LIFESTYLE_HEALTH_FITNESS LIFESTYLE_RELAX LIFESTYLE_ADULT_ONLY LIFESTYLE_ADVENTURE LIFESTYLE_BUSINESS LIFESTYLE_LGBT LIFESTYLE_SINGLE_PARENT LIFESTYLE_SOLO_FEMALE LIFESTYLE_BEAUTY LIFESTYLE_FOODIE LIFESTYLE_FAMILY LIFESTYLE_ROMANCE LIFESTYLE_COUPLE LIFESTYLE_SOLO LIFESTYLE_BACKPACKER LIFESTYLE_SHOPPING LIFESTYLE_SPORTS LIFESTYLE_MOUNTAIN LIFESTYLE_BEACH LIFESTYLE_CITY LIFESTYLE_COUNTRY LIFESTYLE_CULTURE LIFESTYLE_ECO
attribution

Whether image has attribution properties

Array<object>
""
object
url

URL to contributor

string format: uri
""
name
required

Name of contributor

string
"" >= 1 characters
isLandscape

True if media width is greater or equal to height

boolean
location
required

Location

object
x
number format: double
y
number format: double
type
string
coordinates
Array<number>
commissionable
required

Whether this is commissionable or not

boolean
lowestPrice

Best price of the room type or facility ancillary

object
amount
required

Monetary amount value

number
""
currency
required

ISO 4217 currency code

string
"" >= 1 characters /^[A-Z]{3}$/
lowestDisplayPrice

Best price of the room type or facility ancillary in platform currency

object
amount
required

Monetary amount value

number
""
currency
required

ISO 4217 currency code

string
"" >= 1 characters /^[A-Z]{3}$/
pricePoint
required

Level of expensiveness.

string
default: THREE
Allowed values: HALF ONE ONE_HALF TWO TWO_HALF THREE THREE_HALF FOUR FOUR_HALF FIVE
sort

Sort key for controlling display order within the list (0-based)

integer format: int32
""
status

Availability status of this list item; defaults to ACTIVE

string
""
Allowed values: ACTIVE INACTIVE REMOVED
key
additional properties
""
Example

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

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

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

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

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

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

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

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

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