Skip to content

Suggest profile

POST
/api/managing-entity/{managingEntityIdentifier}/extranet/property/profile/suggest
curl --request POST \
--url https://api.wink.travel/api/managing-entity/e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18/extranet/property/profile/suggest \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Wink-Version: 2.0' \
--data '{ "language": "" }'

Uses AI to generate suggested profile copy for the property based on the supplied request, returning the suggestions for review.

managingEntityIdentifier
required
string
""

Suggest for this property identifier

Example
e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18
Wink-Version
string
default: 2.0.0
Allowed values: 2.0
Media type application/json
object
language
required

Language to use

string
"" >= 1 characters
Example
en

OK

Media type application/json
object
website
required

Website URL of the property

string
""
ambiance
required

Property ambiance and atmosphere

string
""
address1

Primary address line

string
""
address2

Secondary address line (apartment, suite, etc.)

string
""
address3

Tertiary address line

string
""
city

City name

string
""
province

Province or state

string
""
postalCode

Postal or zip code

string
""
country

Country name

string
""
phoneNumber

Contact phone number

string
""
emailAddress

Contact email address

string
""
architecture

Architectural style (e.g., Contemporary, Colonial, Art Deco)

string
""
designElements

Key design elements and aesthetic features

string
""
historic

Historical significance or heritage status

string
""
numberOfRooms

Total number of rooms available

string
""
hotelStars

Star rating of the property

string
""
locationCategory

Location category code

string
""
segment

Market segment (e.g., Luxury, Boutique, Business)

string
""
propertyClass

Property classification code

string
""
style

Architectural/design style code

string
""
chain

Hotel chain affiliation if applicable

string
""
brand

Brand or brand identity

string
""
yearBuilt

Year the property was built or renovated

string
""
Example
{
"website": "",
"ambiance": "",
"address1": "",
"address2": "",
"address3": "",
"city": "",
"province": "",
"postalCode": "",
"country": "",
"phoneNumber": "",
"emailAddress": "",
"architecture": "",
"designElements": "",
"historic": "",
"numberOfRooms": "",
"hotelStars": "",
"locationCategory": "",
"segment": "",
"propertyClass": "",
"style": "",
"chain": "",
"brand": "",
"yearBuilt": ""
}

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

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

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

Internal Server Error

object
Example generated
{}