Skip to main content

​
Method

PUT /v1/products/:id/lodging

​
Path Parameters

​
id
uuid
Product ID to link to a lodging property.

​
Body Parameters

​
Headers

​
Authorization
string
Bearer token (requires products:write).
​
content-type
string
application/json

​
Request Example

curl -X PUT "https://api.voyantcloud.com/v1/products/prod_123/lodging" \
  -H "Authorization: Bearer $VOYANT_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "propertyId": "prop_987",
    "ratePlanId": "rate_456",
    "active": true,
    "override": {
      "name": "Voyant Athens Hotel",
      "shortDescription": "Boutique stay near Syntagma Square",
      "currency": "EUR",
      "priceStrategy": "absolute",
      "priceAmountMinor": 18900,
      "amenityKeys": ["wifi", "breakfast"],
      "mediaSetRef": "media_set_123"
    }
  }'

​
Response

{
  "data": {
    "link": {
      "id": "pll_001",
      "productId": "prod_123",
      "propertyId": "prop_987",
      "departureId": null,
      "ratePlanId": "rate_456",
      "roomTypeId": "room_001",
      "active": "true"
    },
    "override": {
      "id": "plo_001",
      "name": "Voyant Athens Hotel",
      "currency": "EUR",
      "priceStrategy": "absolute",
      "priceAmountMinor": 18900,
      "amenityKeys": ["wifi", "breakfast"],
      "mediaSetRef": "media_set_123"
    }
  }
}
If the specified rate plan no longer exists, the API automatically retries with ratePlanId set to null to preserve the link.