Skip to content
Wink

Contribute knowledge

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

Adds partner-supplied knowledge or local insight to a property’s embeddings for enhanced RAG context. The caller must own a mapping for the target property. Uses contributionId as an idempotency key — re-submitting the same ID replaces the previous contribution.

Authorizations

Section titled “Authorizations ”

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 or local insight to a property’s embeddings for enriched RAG context

object
namespace
required

Identifier namespace (HOTEL_CODE, URL_NAME, PLACE_ID, or PARTNER)

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

External identifier value

string
"" >= 1 characters
Example 
BOOKING-987654
contributionId
required

Idempotency key for this contribution (UUID or text); re-submitting the same key replaces previous contribution

string
"" >= 1 characters
Example 
partnership-2026-001-amenities
text
required

Content to contribute (rich text, experience notes, or local insight)

string
"" >= 1 characters
Example 
This luxury property features a 25-metre infinity pool overlooking the Chao Phraya River, award-winning spa, and three Michelin-trained chefs.
factType
required

Fact type: must be PARTNER_KNOWLEDGE (operational data) or PARTNER_LOCAL_INSIGHT (curated local content)

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
Example 
PARTNER_KNOWLEDGE
language
required

ISO 639-1 language code (e.g. en, th, ja)

string
"" >= 1 characters
Example 
en

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Contribution added/updated successfully; returns hotelId and insertedCount

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

400

Section titled “400 ”

Invalid request (invalid factType, namespace, or missing required fields)

401

Section titled “401 ”

Missing or invalid JWT authentication

403

Section titled “403 ”

Caller does not own a mapping for the target property

404

Section titled “404 ”

Property not found for the given namespace and externalId

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

500

Section titled “500 ”

Internal Server Error

object
Example generated
{}