Upsert Lodging Link

Create or update the primary lodging link for a product, including optional property overrides.

Method

PUT /v1/products/:id/lodging

Path Parameters

id · uuid

Product ID to link to a lodging property.

Body Parameters

Show Override object

Headers

Authorization · string

Bearer token (requires products:write).

content-type · string

application/json

Request Example

cURL

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

200 OK

{
  "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.