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

# Créer et modifier des établissements

> Créez un restaurant dans une organisation commerciale et maintenez son profil.

Utilisez ce guide pour ajouter un restaurant à une organisation commerciale existante ou modifier le profil d’un établissement. La découverte des ressources est expliquée dans [Trouver vos ressources](/fr/getting-started/find-your-resources).

## Créer un établissement

Appelez `POST /v1/organizations/{organization_id}/locations` avec une clé limitée à une organisation commerciale. La clé doit posséder `location.create` et l’organisation doit se trouver dans son périmètre.

Le nouvel établissement nécessite `name`, `currency`, `country`, `timezone` et une `address` complète. `default_language`, `contact_information` et `image_url` sont facultatifs. Lorsqu’il est fourni, `image_url` doit désigner une image JPG, PNG ou WebP accessible publiquement et ne dépassant pas 5 Mo ; Chataigne l’importe dans son stockage géré comme photo de profil de l’établissement.

```bash theme={null}
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` est requis pour cette création. Réutilisez la même valeur uniquement lorsque vous retentez exactement le même corps de requête.

La réponse est la ressource `location` créée. Enregistrez son `id` pour les appels de paramètres et de données analytiques.

## Modifier le profil d’un établissement

Appelez `PATCH /v1/locations/{location_id}` avec la permission `location.update`. Envoyez uniquement les champs à modifier :

```bash theme={null}
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-nouveau-logo.png",
    "address": {
      "line2": "Entrée côté cour"
    }
  }'
```

`PATCH` effectue une mise à jour partielle :

* Les champs de premier niveau omis conservent leur valeur actuelle, y compris la photo de profil.
* Un `image_url` fourni est téléchargé, validé, stocké par Chataigne et remplace la photo de profil. Il doit s’agir d’une URL non vide — envoyer `image_url: null` (ou `""`) est rejeté avec `400 INVALID_IMAGE_URL` ; l’API ne permet pas de supprimer une photo existante, omettez donc le champ pour conserver l’actuelle.
* Les champs omis dans `address` conservent également leur valeur actuelle.
* La valeur explicite `null` efface un champ d’adresse nullable tel que `line2`.

La devise, le pays et le fuseau horaire sont définis à la création et ne sont pas modifiés par cet endpoint.

## Champs du profil

| Champ                 | À la création        | À la modification        | Remarques                                                                               |
| --------------------- | -------------------- | ------------------------ | --------------------------------------------------------------------------------------- |
| `name`                | Requis               | Facultatif               | Nom du restaurant affiché aux clients.                                                  |
| `image_url`           | Facultatif           | Facultatif               | URL publique JPG, PNG ou WebP (5 Mo max). La réponse renvoie l’URL gérée par Chataigne. |
| `currency`            | Requis               | —                        | Code de devise ISO pris en charge par Chataigne.                                        |
| `country`             | Requis               | —                        | Code pays ISO pris en charge par Chataigne.                                             |
| `timezone`            | Requis               | —                        | Fuseau horaire IANA tel que `Europe/Paris`.                                             |
| `default_language`    | Facultatif           | Facultatif               | Langue par défaut des conversations clients.                                            |
| `contact_information` | Facultatif           | Facultatif               | Coordonnées affichées pour le restaurant.                                               |
| `address`             | Objet complet requis | Objet partiel facultatif | Rue, code postal, ville, pays, latitude et longitude.                                   |

<Card title="Configurer l’établissement" icon="sliders" href="/fr/location-organization-management/location-settings">
  Continuez avec les commandes, les horaires, la livraison, l’acceptation et les paramètres d’IA.
</Card>