Skip to content
Wink

Update

PUT
/api/managing-entity/{managingEntityIdentifier}/studio/grids/{listIdentifier}
 
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 null

Updates 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 ”
managingEntityIdentifier
required
string
""

Managing entity identifier that owns the grid.

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

Grid identifier to update.

Example 
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51

Header Parameters

Section titled “Header Parameters ”
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Request Body required

Section titled “Request Body required ”

Updated grid definition with revised name, display settings, or inventory/search configuration

Media type application/json

Request payload for creating or updating a sellable list configuration, supplying all display, localization, and inventory settings

object
name
required

Descriptive name of this grid for seller use only

string
"" >= 1 characters
Example 
Luxury Bangkok Properties
customizationIdentifier
required

Customization configuration identifier

string format: uuid
"" >= 1 characters
Example 
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51
descriptions
required

Localized title and description of grid (at least one entry in English required)

Array<object>
"" >= 1 items <= 2147483647 items

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
""
Example 
An example title
description
required

Longer text description

string
"" >= 1 characters <= 2147483647 characters
Example 
This is a longer description in the specified language.
language
required

Indicate which language this description is written in.

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

Whether it was user or system generated.

string
default: USER
Allowed values: SYSTEM USER
Example 
SYSTEM
md5ContentHash

The md5 hash of the name, description and language.

string
""
Example 
d41d8cd98f00b204e9800998ecf8427e
hashMismatch
boolean
Example 
{
  "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
required

Keywords and metadata tags for SEO and filtering

Array<string>
"" >= 1 items <= 2147483647 items
Example 
[
  "bangkok",
  "luxury"
]
listType
required

Type of inventory being curated (LIST, SEARCH, CHANNEL)

string
""
Allowed values: SINGLE LIST SEARCH
Example 
LIST
listIdentifier
required

Inventory record identifier for the curated list, saved search, or channel

string format: uuid
"" >= 1 characters
Example 
8b1d6e0f-3a7c-4d2b-9e5a-1c8f0b4d6e29
animate

Generate an animated GIF from multiple images instead of a static grid (requires at least 2 images)

boolean
Example 
false
animateDelay

Delay between animation frames in milliseconds; -1 disables animation

integer format: int32
default: -1
Example 
500
sort

Badge type and sort order for display on web component (MEMBER, BEST_VALUE, TOP_RATED, etc.)

string
""
Allowed values: MEMBER PRICE_LOW_TO_HIGH PRICE_HIGH_TO_LOW PRICE POPULARITY ECO EXPERIENCE PERK LOYALTY ADD_ON
Example 
MEMBER
displayType
required

Initial display format on the front-facing card (NATIVE or alternative format)

string
default: NATIVE
Allowed values: NATIVE HOTEL ROOM
Example 
NATIVE
Example 
{
  "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 ”

200

Section titled “200 ”

The curated or saved-search grid after applying the requested updates.

Media type application/json

Persisted sellable list configuration that groups inventory items for display as a curated grid or collection on a seller’s web component

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

Managing entity (account owner) identifier

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

Descriptive name of this grid for seller use only

string
"" >= 1 characters
customizationIdentifier
required

Customization configuration identifier

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

Contains localized title and description of grid (at least one entry in English required)

Array<object>
"" >= 1 items <= 2147483647 items

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
keywords
required

Keywords and metadata tags for the grid used for SEO and filtering purposes

Array<string>
"" >= 1 items <= 2147483647 items
status
required

Current status of the grid (ACTIVE, INACTIVE, ARCHIVED)

string
default: ACTIVE
Allowed values: ACTIVE INACTIVE REMOVED
listType
required

List type

string
""
Allowed values: SINGLE LIST SEARCH
listIdentifier
required

Inventory record identifier for the curated list, saved search, or channel (format varies by listType)

string format: uuid
"" >= 1 characters
animate

Generate an animated GIF from multiple images instead of a static grid (requires at least 2 images)

boolean
animateDelay

Delay between animation frames in milliseconds; -1 disables animation

integer format: int32
default: -1
sort

Badge type and sort order for display on the web component (MEMBER, BEST_VALUE, TOP_RATED, etc.)

string
""
Allowed values: MEMBER PRICE_LOW_TO_HIGH PRICE_HIGH_TO_LOW PRICE POPULARITY ECO EXPERIENCE PERK LOYALTY ADD_ON
displayType
required

Indicate which initial values to display first on the front-facing card

string
default: NATIVE
Allowed values: NATIVE HOTEL ROOM
key
additional properties
""
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": "Luxury Bangkok Properties",
  "customizationIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51",
  "descriptions": [],
  "keywords": [
    "bangkok",
    "luxury"
  ],
  "status": "ACTIVE",
  "listType": "LIST",
  "listIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18",
  "animate": false,
  "animateDelay": -1,
  "sort": "MEMBER",
  "displayType": "NATIVE"
}

400

Section titled “400 ”

Bad Request — missing or invalid request parameter or body

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

401

Section titled “401 ”

Unauthorized — authentication is required or the session has expired

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

403

Section titled “403 ”

Forbidden — authenticated but lacking the required permission or scope

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

404

Section titled “404 ”

Not Found — the requested resource does not exist

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

405

Section titled “405 ”

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

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

415

Section titled “415 ”

Unsupported Media Type — use application/json

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

500

Section titled “500 ”

Internal Server Error — an unexpected failure occurred on the server

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

503

Section titled “503 ”

Service Unavailable — a downstream dependency is unreachable

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