> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voyantcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lodging API

> Link products to lodging properties and manage property and room overrides.

## Endpoints

| Method | Path                                 | Description                                                      |
| ------ | ------------------------------------ | ---------------------------------------------------------------- |
| GET    | `/v1/products/:id/lodging`           | Retrieve the lodging link and override for a product.            |
| PUT    | `/v1/products/:id/lodging`           | Create or update the primary lodging link and optional override. |
| DELETE | `/v1/products/:id/lodging`           | Remove the lodging link (and cascading overrides).               |
| GET    | `/v1/products/:id/lodging/links`     | List property links scoped to departures or rate plans.          |
| PATCH  | `/v1/products/:id/lodging/links`     | Bulk upsert property links for a product.                        |
| GET    | `/v1/products/:id/lodging/overrides` | List room-level overrides for a linked property.                 |
| PATCH  | `/v1/products/:id/lodging/overrides` | Bulk upsert room overrides for a linked property.                |

<Info>
  All Lodging endpoints require workspace-scoped API keys. Read operations use the `products:read` scope. Mutations require `products:write`.
</Info>

## Key concepts

* Lodging links associate a product with a lodging property, optionally scoped to a departure, rate plan, or room type.
* Overrides let you customize property naming, descriptions, media, pricing, and policies without changing the source property.
* Room overrides provide per-room availability and pricing adjustments for the product/departure/property combination.
* Bulk endpoints support multi-property products by creating or updating many links/overrides in one request.
* Fallback logic automatically relaxes rate-plan constraints to support legacy data that may not reference a rate plan.