Update
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/studio/grids/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/grids/3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51 \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data nullUpdates the identified curated or saved-search grid owned by the managing entity with the values in the request body. Returns the updated grid.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Managing entity identifier that owns the grid.
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Grid identifier to update.
Example
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51Header Parameters
Section titled “Header Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”Updated grid definition with revised name, display settings, or inventory/search configuration
Request payload for creating or updating a sellable list configuration, supplying all display, localization, and inventory settings
object
Descriptive name of this grid for seller use only
Example
Luxury Bangkok PropertiesCustomization configuration identifier
Example
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51Localized title and description of grid (at least one entry in English required)
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"}Keywords and metadata tags for SEO and filtering
Example
[ "bangkok", "luxury"]Type of inventory being curated (LIST, SEARCH, CHANNEL)
Example
LISTInventory record identifier for the curated list, saved search, or channel
Example
8b1d6e0f-3a7c-4d2b-9e5a-1c8f0b4d6e29Generate an animated GIF from multiple images instead of a static grid (requires at least 2 images)
Example
falseDelay between animation frames in milliseconds; -1 disables animation
Example
500Badge type and sort order for display on web component (MEMBER, BEST_VALUE, TOP_RATED, etc.)
Example
MEMBERInitial display format on the front-facing card (NATIVE or alternative format)
Example
NATIVEExample
{ "name": "Luxury Bangkok Properties", "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": [ "bangkok", "luxury" ], "listType": "LIST", "listIdentifier": "8b1d6e0f-3a7c-4d2b-9e5a-1c8f0b4d6e29", "animate": false, "animateDelay": 500, "sort": "MEMBER", "displayType": "NATIVE"}Responses
Section titled “Responses”The curated or saved-search grid after applying the requested updates.
Lightweight projection of a sellable list used in listings and event payloads, containing all display and configuration fields without audit metadata
object
Unique identifier for this record.
Datetime this record was first created
Datetime this record was last updated
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.
Managing entity (account owner) identifier
Descriptive name of this grid for seller use only
Customization configuration identifier
Localized title and description of grid (at least one entry in English required)
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.
Keywords and metadata tags for SEO and filtering
Current status of the grid (ACTIVE, INACTIVE, ARCHIVED)
Type of inventory being curated (LIST, SEARCH, CHANNEL)
Inventory record identifier for the curated list, saved search, or channel
Generate an animated GIF from multiple images instead of a static grid (requires at least 2 images)
Delay between animation frames in milliseconds; -1 disables animation
Badge type and sort order for display on web component (MEMBER, BEST_VALUE, TOP_RATED, etc.)
Initial display format on the front-facing card (NATIVE or alternative format)
Example
{ "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47", "createdDate": "2026-01-14T09:30:00", "lastUpdate": "2026-02-03T16:45:12", "version": 3, "sellerIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "name": "Luxury Bangkok Properties", "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": [ "bangkok", "luxury" ], "status": "ACTIVE", "listType": "LIST", "listIdentifier": "8b1d6e0f-3a7c-4d2b-9e5a-1c8f0b4d6e29", "animate": false, "animateDelay": 500, "sort": "MEMBER", "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
Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version
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