Update
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/studio/items/3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51';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/studio/items/3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51 \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data nullUpdates an existing inventory card identified by its inventory identifier for the given managing entity. Requires MARKETING:WRITE on the account.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”AffiliateAccount identifier to update item for
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Update inventory with this identifier
Example
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51Header Parameters
Section titled “Header Parameters ”Request Body required
Section titled “Request Body required ”Updated inventory card definition with revised display details, media, and channel configuration
Request payload for creating or updating a sellable item, specifying the inventory, display configuration, and media assets to associate with the listing.
object
Descriptive name of this item for seller use
Example
Deluxe Room with Spa AccessWhich configuration to use with this item
Example
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51Title and description of inventory.
object
Use as title or short text description
Example
An example titleLonger text description
Example
This is a longer description in the specified language.Indicate which language this description is written in.
Example
enWhether it was user or system generated.
Example
SYSTEMThe md5 hash of the name, description and language.
Example
d41d8cd98f00b204e9800998ecf8427eExample
{ "name": "Deluxe River View Suite", "description": "Spacious suite with floor-to-ceiling windows overlooking the Chao Phraya River, featuring a king-size bed, private balcony, and marble bathroom.", "language": "en", "creator": "USER", "md5ContentHash": "a3f1c8e2d74b60912a5c3e9b1d7f4e82"}The type of inventory being offer up for sale
Example
HOTELChannel inventory type is a subset of inventory type in that it does not include the HOTEL type. THe way it works is, as a seller you might want to sell a guest room but instead of showing the price of that guest room, you would like to display the best room type price for the property.
Example
GUEST_ROOMSupplier / Hotel identifier that owns this inventory
Example
e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18The channel inventory record identifier describing the relationship between supplier and seller
Example
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51Reference identifiers to Cloudinary media assets
object
Document identifier
Example
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51Use this identifier to communicate with Cloudinary.
Example
cloudinary-image-1Whether Cloudinary media is a VIDEO or IMAGE.
Example
IMAGECurrently ONLY using Cloudinary to store all image / video assets.
Example
CLOUDINARYSort allows you to control how you want to sort this record in a list of media records.
Example
10Media angle
Example
-90Media width in pixels.
Example
2560Media height in pixels.
Example
1600Instead of deleting the media, choose to un-publish it instead for later re-use. Could be you keep seasonal images of the property.
Example
trueLocalized media captions to give user some context about where this media was taken.
Foundation class for storing multi-language content (names and descriptions) with content change detection throughout the Wink Platform.
object
Use as title or short text description
Example
An example titleLonger text description
Example
This is a longer description in the specified language.Indicate which language this description is written in.
Example
enWhether it was user or system generated.
Example
SYSTEMThe md5 hash of the name, description and language.
Example
d41d8cd98f00b204e9800998ecf8427eExample
{ "name": "Deluxe River View Suite", "description": "Spacious suite with floor-to-ceiling windows overlooking the Chao Phraya River, featuring a king-size bed, private balcony, and marble bathroom.", "language": "en", "creator": "USER", "md5ContentHash": "a3f1c8e2d74b60912a5c3e9b1d7f4e82"}Associate this media with a specific lifestyle type. A user searching and filtering inventory based on lifestyles can be shown relevant media first.
Example
LIFESTYLE_HEALTH_FITNESSWhether image has attribution properties
object
URL to contributor
Example
https://maps.google.com/maps/contrib/111628493169070103594Name of contributor
Example
Samuel AdamsExample
{ "url": "https://maps.google.com/maps/contrib/111628493169070103594", "name": "Samuel Adams"}True if media width is greater or equal to height
Example
trueExample
{ "multimediaIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "identifier": "the-siam-residences/lobby-entrance", "type": "IMAGE", "source": "CLOUDINARY", "sort": 10, "angle": null, "width": 2560, "height": 1600, "published": true, "category": "2", "descriptions": [ { "title": "Lobby Entrance", "description": "Elegant lobby of The Siam Residences", "language": "en" } ], "lifestyleType": null, "attribution": [], "isLandscape": true}Create an animated gif instead of a list of images. Feature currently not available. Feel free to enable and it will become available at a later date.
Example
falseControls animation delay in milliseconds
Example
800The specific badge to display over the image on the Web Component.
Example
POPULARITYIndicate which initial values to display first on the front-facing card
Example
NATIVEExample
{ "name": "Deluxe Room with Spa Access", "customizationIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "descriptions": [ { "name": "Deluxe River View Suite", "description": "Spacious suite with floor-to-ceiling windows overlooking the Chao Phraya River, featuring a king-size bed, private balcony, and marble bathroom.", "language": "en", "creator": "USER", "md5ContentHash": "a3f1c8e2d74b60912a5c3e9b1d7f4e82" } ], "keywords": [ "luxury-accommodation" ], "inventoryType": "HOTEL", "channelInventoryType": "GUEST_ROOM", "supplierIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "channelInventoryIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "multimedias": [ { "multimediaIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "identifier": "the-siam-residences/lobby-entrance", "type": "IMAGE", "source": "CLOUDINARY", "sort": 10, "angle": null, "width": 2560, "height": 1600, "published": true, "category": "2", "descriptions": [ { "title": "Lobby Entrance", "description": "Elegant lobby of The Siam Residences", "language": "en" } ], "lifestyleType": null, "attribution": [], "isLandscape": true } ], "animate": false, "animateDelay": 800, "sort": "POPULARITY", "displayType": "NATIVE"}Responses
Section titled “ Responses ”Updated sellable inventory item
A sellable item represents a curated inventory listing created by an affiliate seller, combining a specific inventory type from a supplier with visual and display configuration for presentation on sales channels.
object
Document UUID
Datetime this record was first created
Datetime this record was last updated
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.
AffiliateAccount / Owner identifier
Descriptive name of this item for seller use
Which configuration to use with this item
Title and description of inventory.
Foundation class for storing multi-language content (names and descriptions) with content change detection throughout the Wink Platform.
object
Use as title or short text description
Longer text description
Indicate which language this description is written in.
Whether it was user or system generated.
The md5 hash of the name, description and language.
Availability status
Url sell status
The type of inventory being offer up for sale
Channel inventory type is a subset of inventory type in that it does not include the HOTEL type. THe way it works is, as a seller you might want to sell a guest room but instead of showing the price of that guest room, you would like to display the best room type price for the property.
Supplier / Hotel identifier that owns this inventory
The channel inventory record identifier describing the relationship between supplier and seller
Reference identifiers to Cloudinary media assets
object
Document identifier
Use this identifier to communicate with Cloudinary.
Whether Cloudinary media is a VIDEO or IMAGE.
Currently ONLY using Cloudinary to store all image / video assets.
Sort allows you to control how you want to sort this record in a list of media records.
Media angle
Media width in pixels.
Media height in pixels.
Instead of deleting the media, choose to un-publish it instead for later re-use. Could be you keep seasonal images of the property.
Supported OTA specification PIC code. See OTA geoname data
Localized media captions to give user some context about where this media was taken.
Foundation class for storing multi-language content (names and descriptions) with content change detection throughout the Wink Platform.
object
Use as title or short text description
Longer text description
Indicate which language this description is written in.
Whether it was user or system generated.
The md5 hash of the name, description and language.
Associate this media with a specific lifestyle type. A user searching and filtering inventory based on lifestyles can be shown relevant media first.
Whether image has attribution properties
object
URL to contributor
Name of contributor
True if media width is greater or equal to height
Create an animated gif instead of a list of images. Feature currently not available. Feel free to enable and it will become available at a later date.
Controls animation delay in milliseconds
The specific badge to display over the image on the Web Component.
Indicate which initial values to display first on the front-facing card
Example
{ "id": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "createdDate": "2026-01-14T09:30:00", "lastUpdate": "2026-01-15T09:30:00", "version": 1, "ownerIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "name": "Deluxe Room with Spa Access", "customizationIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "keywords": [ "luxury-accommodation" ], "status": "ACTIVE", "inventoryStatus": "ACTIVE", "inventoryType": "HOTEL", "channelInventoryType": "GUEST_ROOM", "supplierIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "channelInventoryIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "animate": false, "animateDelay": 800, "displayType": "NATIVE"}Bad Request — missing or invalid request parameter or body
object
object
Example
Unauthorized — authentication is required or the session has expired
object
object
Example
Forbidden — authenticated but lacking the required permission or scope
object
object
Example
Not Found — the requested resource does not exist
object
object
Example
Method Not Allowed — the HTTP verb is not supported on this endpoint
object
object
Example
Unsupported Media Type — use application/json
object
object
Example
Internal Server Error — an unexpected failure occurred on the server
object
object
Example
Service Unavailable — a downstream dependency is unreachable