Skip to content
Wink

Create Grid

POST
/api/managing-entity/{managingEntityIdentifier}/studio/grids
 
curl --request POST \
  --url https://api.wink.travel/api/managing-entity/owner-1/studio/grids \
  --header 'Content-Type: application/json' \
  --header 'Wink-Version: 2.0' \
  --data '{ "name": "", "customizationIdentifier": "", "descriptions": "", "keywords": "", "listType": "SINGLE", "listIdentifier": "", "animate": false, "animateDelay": -1, "sort": "MEMBER", "displayType": "NATIVE" }'

Create a new curated / saved search list

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
managingEntityIdentifier
required
string
""

Create list owned by this owner identifier.

Example 
owner-1

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 ”
Media type application/json
object
name
required

Descriptive name of this list for seller use only

string
"" >= 1 characters
Example 
My list
customizationIdentifier
required

Customization identifier

string format: uuid
"" >= 1 characters
Example 
customization-1
descriptions
required

Contains custom title and description of grid

Array<object>
"" >= 1 items <= 2147483647 items
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
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
""
hashMismatch
boolean
keywords
required

Keywords is meta data for the grid you created that can be used for SEO purposes.

Array<string>
"" >= 1 items <= 2147483647 items
Example 
[
  "bali"
]
listType
required

List type

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

Depending on the listType, this is either the list / search / channel inventory identifier.

string format: uuid
"" >= 1 characters
animate

Create an animated gif instead of a list of images

boolean
Example 
false
animateDelay

Controls animation delay in milliseconds. -1 is disabled

integer format: int32
default: -1
sort

Determines which badge to show on the Web Component. Is also used to sort properties for search grids.

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

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

string
default: NATIVE
Allowed values: NATIVE HOTEL ROOM
Example 
NATIVE

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Created

Media type application/json
object
id

Document UUID

string
""
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

AffiliateAccount identifier

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

Descriptive name of this list for seller use only

string
"" >= 1 characters
customizationIdentifier
required

Customization identifier

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

Contains custom title and description of grid

Array<object>
"" >= 1 items <= 2147483647 items
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
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 is meta data for the grid you created that can be used for SEO purposes.

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

Status

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

List type

string
""
Allowed values: SINGLE LIST SEARCH
listIdentifier
required

Depending on the listType, this is either the list / search / channel inventory identifier.

string format: uuid
"" >= 1 characters
animate

Create an animated gif instead of a list of images

boolean
animateDelay

Controls animation delay in milliseconds. -1 is disabled

integer format: int32
default: -1
sort

Determines which badge to show on the Web Component. Is also used to sort properties for search grids.

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
Example 
{
  "id": "",
  "createdDate": "",
  "lastUpdate": "",
  "version": "",
  "ownerIdentifier": "",
  "name": "",
  "customizationIdentifier": "",
  "descriptions": "",
  "keywords": "",
  "status": "ACTIVE",
  "listType": "SINGLE",
  "listIdentifier": "",
  "animate": false,
  "animateDelay": -1,
  "sort": "MEMBER",
  "displayType": "NATIVE"
}

400

Section titled “400 ”

Bad Request

object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
Example generated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  }
}

401

Section titled “401 ”

Unauthorized

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

403

Section titled “403 ”

Forbidden

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

500

Section titled “500 ”

Internal Server Error

object
Example generated
{}