Create and update locations

Use this guide when you need to add a restaurant to an existing business organization or change the profile of an existing location. Resource discovery belongs in Find your resources.

Create a location

Call POST /v1/organizations/{organization_id}/locations with a business-organization-scoped key. The key needs location.create, and the organization must be in its scope. The initial location requires name, currency, country, timezone, and a complete address. default_language, contact_information, and image_url are optional. When supplied, image_url must be a publicly reachable JPG, PNG, or WebP image no larger than 5 MB; Chataigne imports it into managed storage for the location profile picture.

curl https://server.chataigne.ai/v1/organizations/busorg_k3m9x2p7qw/locations \
  -X POST \
  -H "x-api-key: $CHATAIGNE_API_KEY" \
  -H "Idempotency-Key: 2d0876fa-dab8-43a3-b2f8-dd303e7633f5" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Maison Exemple — République",
    "currency": "EUR",
    "country": "FR",
    "timezone": "Europe/Paris",
    "default_language": "fr",
    "contact_information": "+33 1 84 80 20 20",
    "image_url": "https://images.example.com/maison-exemple-logo.png",
    "address": {
      "line1": "12 place de la République",
      "line2": null,
      "postal_code": "75011",
      "city": "Paris",
      "country": "FR",
      "latitude": 48.8674,
      "longitude": 2.363
    }
  }'

Idempotency-Key is required for this creation request. Reuse the same value only when retrying the same request body. The response is the created location resource. Store its id for later settings and analytics calls.

Update a location profile

Call PATCH /v1/locations/{location_id} with location.update. Send only the fields you want to change:

curl https://server.chataigne.ai/v1/locations/loc_r8v4n2c6tz \
  -X PATCH \
  -H "x-api-key: $CHATAIGNE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Maison Exemple — République & Oberkampf",
    "contact_information": "+33 1 84 80 20 21",
    "image_url": "https://images.example.com/maison-exemple-new-logo.png",
    "address": {
      "line2": "Entrée côté cour"
    }
  }'

PATCH is a partial update:

Omitted top-level fields keep their current value, including the current profile picture.
A supplied image_url is downloaded, validated, stored by Chataigne, and replaces the profile picture. It must be a non-empty URL — sending image_url: null (or "") is rejected with 400 INVALID_IMAGE_URL; the API has no way to clear an existing picture, so omit the field to keep the current one.
Omitted fields inside address also keep their current value.
An explicit null clears a nullable address field such as line2.

Currency, country, and timezone are set when the location is created and are not changed by this endpoint.

Location profile fields

Field	Created with	Updated with	Notes
`name`	Required	Optional	Customer-facing restaurant name.
`image_url`	Optional	Optional	Public JPG, PNG, or WebP URL (max 5 MB). The response returns Chataigne’s managed URL.
`currency`	Required	—	ISO currency code supported by Chataigne.
`country`	Required	—	ISO country code supported by Chataigne.
`timezone`	Required	—	IANA timezone such as `Europe/Paris`.
`default_language`	Optional	Optional	Default language for customer conversations.
`contact_information`	Optional	Optional	Contact text exposed for the restaurant.
`address`	Required, complete object	Optional, partial object	Includes street, postal code, city, country, latitude, and longitude.

Configure the location

Continue with ordering, hours, delivery, acceptance, and AI settings.

​Create a location

​Update a location profile

​Location profile fields

Configure the location

Create a location

Update a location profile

Location profile fields