Bulk Upsert Lodging Links

Link a product to multiple properties (and optional departure/rate plan scopes) in a single request.

Method

PATCH /v1/products/:id/lodging/links

Path Parameters

id · uuid

Product ID for the links.

Body Parameters

Headers

Authorization · string

Bearer token (requires products:write).

content-type · string

application/json

Request Example

cURL

curl -X PATCH "https://api.voyantcloud.com/v1/products/prod_123/lodging/links" \
  -H "Authorization: Bearer $VOYANT_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "propertyIds": ["prop_987", "prop_654"],
    "departureId": "dep_456"
  }'

Response

200 OK

{
  "data": [
    {
      "id": "pll_001",
      "property_id": "prop_987",
      "departure_id": "dep_456",
      "rate_plan_id": "rate_002",
      "active": "true"
    },
    {
      "id": "pll_002",
      "property_id": "prop_654",
      "departure_id": "dep_456",
      "rate_plan_id": "rate_002",
      "active": "true"
    }
  ]
}

If a property is already linked with the same scope, it is returned unchanged. When a rate plan no longer exists, the API retries with ratePlanId set to null to maintain the link.