Remove

DELETE

/api/managing-entity/{managingEntityIdentifier}/studio/dynamic-list/{listIdentifier}

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: 'DELETE',
  headers: {'Wink-Version': '2.0', Authorization: 'Bearer <token>'}
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --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 'Wink-Version: 2.0'

Permanently removes the saved search identified by its identifier.

Authorizations

oauth2ClientCredentials

Parameters

Path Parameters

managingEntityIdentifier

required

string

Remove search owned by this managing entity.

Example

d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69

listIdentifier

required

string

Saved search identifier.

Example

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

Header Parameters

Wink-Version

string

default: 2.0.0

Allowed values: 2.0

Responses

200

Saved search removed and the deleted record returned.

application/json

Lightweight projection of a saved dynamic inventory search, including all filter criteria and sort preferences.

object

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

ownerIdentifier

required

Entity identifier of record creator

string format: uuid

"" >= 1 characters

name

required

Name of dynamic list for when user want to persist it

string

"" >= 1 characters

propertyName

Regex expression filter matching on property name.

string

locationCategories

Supported OTA specification LOC code. See OTA geoname data

Array<string>

segmentCategories

Supported OTA specification SEG code. See OTA geoname data

Array<string>

hotelCategories

Supported OTA specification PCT code. See OTA geoname data

Array<string>

architecturalStyles

Supported OTA specification ARC code. See OTA geoname data

Array<string>

inventoryName

Regex expression filter matching on inventory name

string

continents

Continent filter

Array<string>

countries

Country filter

Array<string>

cities

City filter

Array<string>

showEcoFriendly

Filter on eco-friendly hotels

boolean

showPetFriendly

Filter on pet-friendly hotels

boolean

showChildFriendly

Filter on child-friendly hotels

boolean

showPopular

Filter on hotel that has had a certain amount of bookings

boolean

showDirectOnly

Filter on direct inventory

boolean

lifestyles

Filter on lifestyles

Array<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

hotelStars

Filter on number of stars the hotel has.

integer format: int32

aggregateReviewRating

Filter on aggregate review score the hotel has

integer format: int32

nearPoint

Find hotels close to certain location

object

number format: double

type

string

coordinates

Array<number>

radiusInMeters

Use this in conjunction with nearPoint. Control the distance from point we are searching for.

integer format: int64

inventoryTypes

Filter on inventory types

Array<string>

Allowed values: GUEST_ROOM ADD_ON MEETING_ROOM RESTAURANT SPA ATTRACTION PLACE ACTIVITY

primaryOrderBy

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

string

key

additional properties

Example

{
  "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47",
  "createdDate": "2026-01-14T09:30:00",
  "lastUpdate": "2026-02-03T16:45:12",
  "version": 3,
  "ownerIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69",
  "name": "Bangkok Luxury Hotels",
  "propertyName": "The Siam",
  "locationCategories": 1701,
  "segmentCategories": 7,
  "hotelCategories": 1,
  "architecturalStyles": 50,
  "inventoryName": "Deluxe Suite",
  "continents": [
    "AS"
  ],
  "countries": [
    "1605651"
  ],
  "cities": [
    "1609350"
  ],
  "showEcoFriendly": false,
  "showPetFriendly": false,
  "showChildFriendly": false,
  "showPopular": false,
  "showDirectOnly": false,
  "lifestyles": "LIFESTYLE_RELAX",
  "hotelStars": 5,
  "aggregateReviewRating": 8,
  "radiusInMeters": 5000,
  "inventoryTypes": [
    "GUEST_ROOM"
  ],
  "primaryOrderBy": "4"
}

400

Bad Request — missing or invalid request parameter or body

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

Unauthorized — authentication is required or the session has expired

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

Forbidden — authenticated but lacking the required permission or scope

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

Not Found — the requested resource does not exist

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

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

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

409

Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version

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

Unsupported Media Type — use application/json

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

Internal Server Error — an unexpected failure occurred on the server

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

Service Unavailable — a downstream dependency is unreachable

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