Location Management - Chataigne Docs

Location Management covers the changes you make after discovering your resources: creating a restaurant inside a business organization, updating its profile, and configuring its day-to-day ordering behavior. If you still need to find an organization or location ID, start with Find your resources.

Create or update a location

Add a restaurant to an organization or maintain its profile and address.

Location settings

Choose the operational settings you want to read or change.

Opening hours

Replace the weekly delivery and pickup schedules.

Special closings

Schedule holidays, private events, and other exceptional closures.

Settings belong to a location

Each settings resource has its own endpoint below:

/v1/locations/{location_id}
├── /order_settings
├── /opening_hours
├── /delivery_settings
├── /acceptance_settings
├── /ai_instructions
└── /special_closings

Read the current value before making a change. Most settings use PATCH, so omitted fields keep their current value. Opening hours use PUT: the submitted schedule replaces the current one.

Permissions

Location Management permissions are separate so that you can grant an integration only the actions it needs.

Task	Permission
Create a location in an organization	`location.create`
Update a location profile	`location.update`
Read or write order settings	`orderSettings.read` / `orderSettings.write`
Read or replace opening hours	`openingHoursSettings.read` / `openingHoursSettings.write`
Read or write delivery settings	`deliverySettings.read` / `deliverySettings.write`
Read or write order acceptance	`locationStatusSettings.read` / `locationStatusSettings.write`
Read or write AI clerk instructions	`ai.read` / `ai.write`
Read or manage special closings	`openingHoursSettings.read` / `openingHoursSettings.write`

The target location must also be inside the key’s scope.