Update
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/studio/dynamic-list/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/dynamic-list/3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51 \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data nullUpdates an existing saved search identified by its identifier with the supplied filters.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Update search owned by this managing entity.
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Saved search identifier.
Example
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51Header Parameters
Section titled “Header Parameters”Request Bodyrequired
Section titled “Request Bodyrequired”Updated dynamic list definition with revised filter criteria, sorting rules and display settings
Request payload to create or update a dynamic inventory search list with filter criteria and sort preferences.
object
Filter on aggregate review score the hotel has
Example
8City filter
Continent filter
Country filter
Filter on number of stars the hotel has.
Example
5Regex expression filter matching on inventory name
Example
Deluxe SuiteFilter on inventory types
Filter on lifestyles
Example
LIFESTYLE_RELAXName of dynamic list for when user want to persist it
Example
Bangkok Luxury HotelsFind hotels close to certain location
object
Control how you want the search results sorted. Options are:
- 1: Inventory name
- 2: Price: High to low
- 3: Price: Low to high
- 4: Commission: High to low
- 5: Commission: Low to high
- 6: Discount: High to low
- 7: Discount: Low to high
Example
4Regex expression filter matching on property name.
Example
The SiamUse this in conjunction with nearPoint. Control the distance from point we are searching for.
Example
5000Filter on child-friendly hotels
Example
falseFilter on direct inventory
Example
falseFilter on eco-friendly hotels
Example
falseFilter on pet-friendly hotels
Example
falseFilter on hotel that has had a certain amount of bookings
Example
falseExample
{ "aggregateReviewRating": 8, "architecturalStyles": 50, "cities": [ "1609350" ], "continents": [ "AS" ], "countries": [ "1605651" ], "hotelCategories": 1, "hotelStars": 5, "inventoryName": "Deluxe Suite", "inventoryTypes": [ "GUEST_ROOM" ], "lifestyles": "LIFESTYLE_RELAX", "locationCategories": 1701, "name": "Bangkok Luxury Hotels", "primaryOrderBy": "4", "propertyName": "The Siam", "radiusInMeters": 5000, "segmentCategories": 7, "showChildFriendly": false, "showDirectOnly": false, "showEcoFriendly": false, "showPetFriendly": false, "showPopular": false}Responses
Section titled “Responses”Saved search updated successfully.
Lightweight projection of a saved dynamic inventory search, including all filter criteria and sort preferences.
object
Filter on aggregate review score the hotel has
Supported OTA specification ARC code. See OTA geoname data
City filter
Continent filter
Country filter
Datetime this record was first created
Supported OTA specification PCT code. See OTA geoname data
Filter on number of stars the hotel has.
Unique identifier for this record.
Regex expression filter matching on inventory name
Filter on inventory types
Datetime this record was last updated
Filter on lifestyles
Supported OTA specification LOC code. See OTA geoname data
Name of dynamic list for when user want to persist it
Find hotels close to certain location
object
Entity identifier of record creator
Control how you want the search results sorted. Options are:
- 1: Inventory name
- 2: Price: High to low
- 3: Price: Low to high
- 4: Commission: High to low
- 5: Commission: Low to high
- 6: Discount: High to low
- 7: Discount: Low to high
Regex expression filter matching on property name.
Use this in conjunction with nearPoint. Control the distance from point we are searching for.
Supported OTA specification SEG code. See OTA geoname data
Filter on child-friendly hotels
Filter on direct inventory
Filter on eco-friendly hotels
Filter on pet-friendly hotels
Filter on hotel that has had a certain amount of bookings
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.
Example
{ "aggregateReviewRating": 8, "architecturalStyles": 50, "cities": [ "1609350" ], "continents": [ "AS" ], "countries": [ "1605651" ], "createdDate": "2026-01-14T09:30:00", "hotelCategories": 1, "hotelStars": 5, "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47", "inventoryName": "Deluxe Suite", "inventoryTypes": [ "GUEST_ROOM" ], "lastUpdate": "2026-02-03T16:45:12", "lifestyles": "LIFESTYLE_RELAX", "locationCategories": 1701, "name": "Bangkok Luxury Hotels", "ownerIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "primaryOrderBy": "4", "propertyName": "The Siam", "radiusInMeters": 5000, "segmentCategories": 7, "showChildFriendly": false, "showDirectOnly": false, "showEcoFriendly": false, "showPetFriendly": false, "showPopular": false, "version": 3}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