Skip to content
Wink

Contribute Partner Knowledge

POST
/api/property-embeddings/external/contribute
 
curl --request POST \
  --url https://api.wink.travel/api/property-embeddings/external/contribute \
  --header 'Content-Type: application/json' \
  --header 'Wink-Version: 2.0' \
  --data null

Contribute knowledge to a property’s embeddings. Requires a registered mapping for the target property.

Parameters

Section titled “ Parameters ”

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

Contribute partner knowledge to a property’s embeddings

object
namespace
required

Identifier namespace

string
""
Allowed values: HOTEL_CODE URL_NAME PLACE_ID PARTNER
externalId
required

External identifier value

string
"" >= 1 characters
Example 
IN00011
contributionId
required

Idempotency key for this contribution

string
"" >= 1 characters
Example 
review-2024-001
text
required

Content to contribute

string
"" >= 1 characters
factType
required

Fact type (PARTNER_KNOWLEDGE or PARTNER_LOCAL_INSIGHT)

string
""
Allowed values: HOTEL_DESCRIPTION AMENITY EXPERIENCE INVENTORY POLICY LOCATION GUEST_REVIEW RATE_SUMMARY SOCIAL_POST_GENERATED STAFF_NOTE COMPETITOR_INSIGHT PARTNER_KNOWLEDGE PARTNER_LOCAL_INSIGHT
language
required

ISO 639-1 language code

string
"" >= 1 characters
Example 
en

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Created

Media type application/json
object
key
additional properties
Example generated
{
  "additionalProperty": "example"
}

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