# Unisoft — Documentation complète

**Versions de l’API** · [V2 (Latest)](/integrations/v2/docs?lang=fr) · **V1**

> **Cette version de l’API est obsolète.** Utilisez la dernière version pour toute nouvelle intégration. [Voir la documentation actuelle](/integrations/v2/docs?lang=fr)

## Votre premier appel

Commencez par une lecture pour vérifier votre connexion avant toute écriture.

### 1. Préparer votre clé

Dans le backoffice Unisoft, ouvrez Développeurs, créez une clé API et accordez uniquement les permissions nécessaires à votre intégration. Copiez la clé lors de sa création.

### 2. Choisir le bon environnement

La production et le développement ont des domaines distincts. Utilisez une clé créée dans l’environnement appelé.

```shell
PRODUCTION=https://api.unisoft.world/integrations/v1
DEVELOPMENT=https://kehilaapi.syn-assist.fr/integrations/v1
```

### 3. Vérifier la connexion

```shell
export UNISOFT_API_URL='https://api.unisoft.world/integrations/v1'
export UNISOFT_API_KEY='ke_live_REPLACE_WITH_YOUR_KEY'

curl --fail-with-body "$UNISOFT_API_URL/me" \
  --header "Authorization: Bearer $UNISOFT_API_KEY"
```

GET /me retourne l’organisation, les permissions de la clé et les langues activées. Vérifiez ces informations avant de continuer.

### Exemple

```json
{
  "success": true,
  "data": {
    "apiKey": {
      "id": "key_example",
      "name": "Example integration",
      "prefix": "ke_live_",
      "scopes": [
        "contacts:read"
      ]
    },
    "organisation": {
      "id": "org_example",
      "name": "Example organisation",
      "shortName": "Example",
      "defaultLanguage": "fr",
      "enabledLanguages": [
        "fr",
        "en"
      ]
    }
  }
}
```

### 4. Lire vos premiers contacts

Cet appel nécessite la permission contacts:read. Les paramètres de recherche disponibles figurent dans la référence API.

```shell
curl --fail-with-body "$UNISOFT_API_URL/contacts?limit=10" \
  --header "Authorization: Bearer $UNISOFT_API_KEY"
```


## Authentification

Une clé, un périmètre et des permissions explicites.

Transmettez votre clé dans Authorization: Bearer ou X-API-Key. Ne la placez jamais dans une URL ni dans le code public d’un site.

```shell
Authorization: Bearer ke_live_REPLACE_WITH_YOUR_KEY
```

Une clé ke_live_ est rattachée à une seule organisation. Les permissions de lecture, d’écriture et d’envoi sont distinctes. Chaque opération indique les permissions acceptées.

### Comprendre une erreur

401 MISSING_API_KEY ou INVALID_API_KEY : vérifiez la clé, l’en-tête et l’environnement. 403 INSUFFICIENT_SCOPE : vérifiez les permissions requises par l’opération.

Les autres erreurs métier sont décrites par opération. Conservez le code HTTP et le champ error pour diagnostiquer un échec.

Après un délai d’attente sur une écriture ou un envoi, vérifiez le résultat avant de réessayer : toutes les opérations ne sont pas idempotentes.


## Données et pagination

Les conventions à vérifier avant de lire ou modifier vos données.

### Parcourir une liste

Les listes paginées exposent data et meta. Reprenez meta.nextCursor dans cursor tant que meta.hasMore vaut true, en conservant vos filtres. La limite habituelle est de 50 éléments, avec un maximum de 200 ; vérifiez les paramètres de chaque opération.

```shell
GET /contacts?limit=50
GET /contacts?limit=50&cursor=NEXT_CURSOR
```

### Montants et devises

Les montants des paiements sont exprimés en unités mineures : 1500 représente 15,00 EUR. Les promesses utilisent des unités majeures. Vérifiez toujours le schéma du champ et sa devise.

### Modifier un contenu multilingue

La langue principale de l’organisation se trouve à la racine de l’objet. Les autres langues sont des objets partiels sous leur code de langue. Lisez defaultLanguage et enabledLanguages dans GET /me.

```json
{
  "label": "Restaurant",
  "en": {"label": "Restaurant"},
  "he": {"label": "מסעדה"}
}
```

Dans un PATCH, un champ absent reste inchangé. Un overlay de langue à null supprime cette traduction. Les règles de suppression des autres champs dépendent de leur schéma.

**Contenu multilingue (à lire avant de renseigner un champ texte).** Le contenu traduisible n’utilise PAS une correspondance `{fr:…, en:…}`. À la place :
- La valeur dans la **langue par défaut** de l’organisation (`org.language`) se trouve à la **RACINE** de l’objet — jamais sous sa propre clé de langue.
- Chaque **autre** langue activée par l’organisation (`org.languages`) est une **surcharge partielle**, indexée par son code de langue et ne contenant que les champs traduisibles.

```json
{ "label": "Restaurant", "he": { "label": "מסעדה" } }   // org default = French
```

Les clés de surcharge valides sont **dynamiques pour chaque organisation** : ses langues activées, moins la langue par défaut. L’envoi de la langue par défaut comme surcharge est rejeté (cela dupliquerait la racine) ; une langue non prise en charge est ignorée sans avertissement. Un champ absent d’une surcharge reprend la valeur de la racine.

**Modifier ou supprimer une traduction** — lors d’une mise à jour partielle (`PATCH`), l’omission d’une clé signifie *« la laisser telle quelle »*. Par conséquent :

| Corps | Effet sur la traduction `he` |
|---|---|
| `{"he": {"label": "מסעדה"}}` | créée ou remplacée |
| *(clé omise)* | laissée intacte |
| `{"he": null}` | **supprimée** (toute la surcharge `he` est retirée) |
| `{"he": {}}` | également supprimée — une surcharge vide ne contient aucune traduction |

Pour supprimer une traduction, envoyez explicitement null pour cette langue. Un objet de traduction vide est également traité comme une suppression ; omettre la langue préserve sa valeur actuelle.

**La langue par défaut est contrôlée selon l’opération, et non selon la clé.** L’envoyer comme surcharge pour l’ÉCRIRE est rejeté (`{"fr": {"label": "…"}}` dans une organisation dont le français est la langue par défaut) — la langue par défaut doit se trouver à la racine. En revanche, `{"fr": null}` est accepté : cela SUPPRIME une surcharge dans cette langue. C’est important lorsqu’une organisation change de langue par défaut — une surcharge dans la nouvelle langue par défaut persiste dans les documents et prévaut sur la valeur racine lors de l’affichage ; sa suppression doit donc rester possible. Voir le schéma `I18nOverlay`.


## Recevoir les webhooks

Recevez les événements Unisoft sur votre serveur et vérifiez leur signature.

Dans Développeurs, configurez une destination HTTPS et les événements à recevoir. Conservez le secret affiché lors de la création ou de la rotation.

Vérifiez la signature HMAC SHA-256 sur le corps brut et le timestamp avant de lire le JSON. Enregistrez l’événement avant de répondre avec un statut 2xx, puis traitez-le de façon asynchrone.

```shell
signed_payload = X-Unisoft-Timestamp + "." + raw_body
expected_signature = "sha256=" + HMAC_SHA256_HEX(secret, signed_payload)
```

Utilisez l’identifiant de l’événement pour éviter un traitement en double. Les livraisons peuvent être répétées ou arriver dans un ordre différent.

Les formats, exemples, en-têtes et règles de nouvelle tentative sont détaillés dans le contrat des webhooks ci-dessous et dans x-webhooks du fichier OpenAPI.

### Webhooks de paiement

Unisoft envoie une requête HTTP POST avec Content-Type: application/json à l’URL HTTPS configurée dans Developers > Outbound webhooks. Le secret d’intégration n’est affiché qu’une seule fois, à la création ou à la rotation ; aucune clé API n’est envoyée à votre opération.

Vérifiez `X-Unisoft-Signature` par rapport à `"sha256=" + hex(HMAC-SHA256(secret, X-Unisoft-Timestamp + "." + rawBody))`. Utilisez les octets exacts de la requête brute, AVANT l’analyse du JSON (les fonctions HTTPS Firebase exposent `req.rawBody`). Utilisez une comparaison résistante aux attaques temporelles et rejetez les horodatages non numériques ou obsolètes ; la tolérance recommandée est de 300 secondes. L’horodatage est en secondes Unix et est renouvelé à chaque tentative.

Accusez réception avec n’importe quelle réponse 2xx dans les 10 secondes ; le corps de la réponse est ignoré. Enregistrez l’événement ou placez-le en file avant l’accusé de réception, puis traitez-le de façon asynchrone. Dédupliquez par l’identifiant de l’enveloppe (également `X-Unisoft-Event-Id`) ; il reste stable lors des nouvelles tentatives de livraison, tandis que `attempt` augmente. `createdAt` est la date de mise en file, pas nécessairement la date du paiement. Les livraisons peuvent être dupliquées ou arriver dans le désordre.

Les erreurs réseau, délais d’attente dépassés, réponses 5xx, 408 et 429 entraînent de nouvelles tentatives, jusqu’à 6. Les autres réponses 4xx sont définitives. Après 20 échecs consécutifs de l’intégration, la destination est mise en quarantaine pendant 24 heures. La livraison n’est pas garantie sans limite ; rapprochez les données avec GET /paiements si nécessaire.

Les données de paiement sont un instantané du paiement au moment de l’émission, et non un événement bancaire normalisé. `amount` est exprimé en unités mineures, `devise` indique la devise, `contact` est un identifiant de contact (pas un objet contact) et `info` contient l’identité du donateur. Les champs supplémentaires varient selon le fournisseur et le type. `externalRef` et `externalMetadata` sont inclus s’ils existent ; les anciens paiements peuvent ne pas les contenir. Ne vous fiez pas aux champs propres à un fournisseur. Ces charges utiles peuvent contenir des données personnelles.

#### paiement.success / paiement.refunded

Abonnez-vous à paiement.success pour les paiements terminés et à paiement.refunded pour les remboursements confirmés. Les notifications de remboursement contiennent le paiement d’origine avec son état de remboursement mis à jour ; `amount` conserve le montant du paiement d’origine. La réponse synchrone de l’API de remboursement est un objet différent.

Exemple de paiement.success (champs représentatifs ; des champs propres au fournisseur peuvent également être présents) :

```json
{
  "id": "800efee9-9414-4392-98d0-2ebf6759f617",
  "type": "paiement.success",
  "organisation": "org_example",
  "createdAt": "2026-10-16T11:00:00.000Z",
  "attempt": 1,
  "data": {
    "id": "cf161b09-6bab-4a24-9c7b-c8f223b18c09",
    "organisation": "org_example",
    "name": "Donation",
    "state": "COMPLETED",
    "type": "GENERAL",
    "platform": "STRIPE",
    "method": "CB",
    "amount": 1500,
    "devise": "eur",
    "contact": "contact_example",
    "info": {
      "prenom": "Sarah",
      "nom": "Cohen",
      "email": "sarah@example.org",
      "tel": ""
    },
    "datetime": "2026-10-16T10:00:00.000Z",
    "externalRef": "commande-1234",
    "externalMetadata": {
      "registrationId": "inscription-567",
      "eventId": "chabbat-890"
    }
  }
}
```

Exemple de paiement.refunded (champs représentatifs ; des champs propres au fournisseur peuvent également être présents) :

```json
{
  "id": "800efee9-9414-4392-98d0-2ebf6759f617",
  "type": "paiement.refunded",
  "organisation": "org_example",
  "createdAt": "2026-10-16T11:00:00.000Z",
  "attempt": 1,
  "data": {
    "id": "cf161b09-6bab-4a24-9c7b-c8f223b18c09",
    "organisation": "org_example",
    "name": "Donation",
    "state": "REFUNDED",
    "type": "GENERAL",
    "platform": "STRIPE",
    "method": "CB",
    "amount": 1500,
    "devise": "eur",
    "contact": "contact_example",
    "info": {
      "prenom": "Sarah",
      "nom": "Cohen",
      "email": "sarah@example.org",
      "tel": ""
    },
    "datetime": "2026-10-16T10:00:00.000Z",
    "externalRef": "commande-1234",
    "externalMetadata": {
      "registrationId": "inscription-567",
      "eventId": "chabbat-890"
    },
    "refund": {
      "state": "SUCCEEDED",
      "reason": "requested_by_customer",
      "updatedAt": "2026-10-16T11:00:00.000Z"
    }
  }
}
```

#### En-têtes

| En-tête | Signification |
|---|---|
| X-Unisoft-Event | Identique à body.type |
| X-Unisoft-Event-Id | Identique à body.id ; clé de déduplication |
| X-Unisoft-Delivery-Id | Identifiant de l’enregistrement de livraison pour cette destination |
| X-Unisoft-Timestamp | Secondes Unix |
| X-Unisoft-Signature | sha256= suivi du HMAC en hexadécimal minuscule |

#### Test de connectivité

Le bouton Test du back-office envoie webhook.test via la file signée habituelle, indépendamment de la liste des événements auxquels vous êtes abonné. Il ne crée aucun paiement ni remboursement. Ses données contiennent `test:true`, `triggeredBy` (identifiant d’accès administrateur ou null) et `message`. Des schémas lisibles par machine propres à chaque événement sont également disponibles sous `x-webhooks` dans openapi.json.


## Connecter un assistant IA

Le MCP expose les outils et leurs workflows métier aux clients compatibles.

```shell
https://api.unisoft.world/integrations/mcp
```

Activez le MCP dans Développeurs puis connectez votre client compatible. L’autorisation et les permissions de l’organisation restent nécessaires.

Le MCP publie cinq skills métier. Le client peut charger le workflow utile directement, sans téléchargement séparé. Le manifeste décrit aussi les fichiers disponibles.

Pour un assistant qui lit des fichiers, utilisez l’index llms.txt ou les exports Markdown. Ils documentent l’API ; ils n’accordent aucun accès supplémentaire.


## Unisoft — API d’intégration

OpenAPI 3.0.3 · API 1.0.0

```json
[
  {
    "url": "https://api.unisoft.world/integrations/v1",
    "description": "API"
  }
]
```

API d’intégration Unisoft pour les outils no-code (Make, n8n, Zapier) et les agents d’IA (via le serveur MCP).

**Deux mécanismes :**
1. **Opérations de l’API** documentées ci-dessous — accès en lecture aux contacts, paiements et abonnements ; gestion complète des **formulaires** (définitions et soumissions, y compris acceptation/refus), des **cagnottes** et des sites de **tourisme (Travel)** (configuration et lieux). Voir les rubriques correspondantes.
2. **Webhooks sortants** — Unisoft notifie une URL configurée lors de chaque événement métier (`paiement.success`, `paiement.refunded`, `form.submitted`, `contact.created`). Les charges utiles de paiement, exemples, en-têtes de signature et règles de livraison sont décrits dans l’extension fournisseur `x-webhooks` de cette spécification (le mot-clé racine `webhooks` est réservé à OAS 3.1 ; cette spécification est en 3.0).

**Authentification :** en-tête `Authorization: Bearer ke_live_xxx` ou `X-API-Key: ke_live_xxx`.
Les clés sont générées dans `Settings > Developers` du back-office Unisoft.
Les opérations globaux de création de modèles d’email constituent la seule exception : ils nécessitent le jeton `kc_live_*`, sans organisation, configuré dans `EMAIL_TEMPLATE_CATALOG_TOKEN`. Leur spécification autonome plus légère est disponible à `/integrations/v1/email-template-catalog/openapi.json`.

**Pagination :** basée sur un curseur. Réponse `{data: [...], meta: {nextCursor, hasMore}}`. Pour la page suivante, ajoutez `?cursor=<nextCursor>`.

**Isolation des organisations :** chaque clé ordinaire `ke_live_*` est liée à une organisation. Toutes ses réponses sont limitées à cette organisation. Le jeton de catalogue `kc_live_*` n’est lié à aucune organisation et peut accéder uniquement aux opérations globales de création du catalogue.

### Webhooks de paiement

Unisoft envoie une requête HTTP POST avec Content-Type: application/json à l’URL HTTPS configurée dans Developers > Outbound webhooks. Le secret d’intégration n’est affiché qu’une seule fois, à la création ou à la rotation ; aucune clé API n’est envoyée à votre opération.

Vérifiez `X-Unisoft-Signature` par rapport à `"sha256=" + hex(HMAC-SHA256(secret, X-Unisoft-Timestamp + "." + rawBody))`. Utilisez les octets exacts de la requête brute, AVANT l’analyse du JSON (les fonctions HTTPS Firebase exposent `req.rawBody`). Utilisez une comparaison résistante aux attaques temporelles et rejetez les horodatages non numériques ou obsolètes ; la tolérance recommandée est de 300 secondes. L’horodatage est en secondes Unix et est renouvelé à chaque tentative.

Accusez réception avec n’importe quelle réponse 2xx dans les 10 secondes ; le corps de la réponse est ignoré. Enregistrez l’événement ou placez-le en file avant l’accusé de réception, puis traitez-le de façon asynchrone. Dédupliquez par l’identifiant de l’enveloppe (également `X-Unisoft-Event-Id`) ; il reste stable lors des nouvelles tentatives de livraison, tandis que `attempt` augmente. `createdAt` est la date de mise en file, pas nécessairement la date du paiement. Les livraisons peuvent être dupliquées ou arriver dans le désordre.

Les erreurs réseau, délais d’attente dépassés, réponses 5xx, 408 et 429 entraînent de nouvelles tentatives, jusqu’à 6. Les autres réponses 4xx sont définitives. Après 20 échecs consécutifs de l’intégration, la destination est mise en quarantaine pendant 24 heures. La livraison n’est pas garantie sans limite ; rapprochez les données avec GET /paiements si nécessaire.

Les données de paiement sont un instantané du paiement au moment de l’émission, et non un événement bancaire normalisé. `amount` est exprimé en unités mineures, `devise` indique la devise, `contact` est un identifiant de contact (pas un objet contact) et `info` contient l’identité du donateur. Les champs supplémentaires varient selon le fournisseur et le type. `externalRef` et `externalMetadata` sont inclus s’ils existent ; les anciens paiements peuvent ne pas les contenir. Ne vous fiez pas aux champs propres à un fournisseur. Ces charges utiles peuvent contenir des données personnelles.

#### paiement.success / paiement.refunded

Abonnez-vous à paiement.success pour les paiements terminés et à paiement.refunded pour les remboursements confirmés. Les notifications de remboursement contiennent le paiement d’origine avec son état de remboursement mis à jour ; `amount` conserve le montant du paiement d’origine. La réponse synchrone de l’API de remboursement est un objet différent.

Exemple de paiement.success (champs représentatifs ; des champs propres au fournisseur peuvent également être présents) :

```json
{
  "id": "800efee9-9414-4392-98d0-2ebf6759f617",
  "type": "paiement.success",
  "organisation": "org_example",
  "createdAt": "2026-10-16T11:00:00.000Z",
  "attempt": 1,
  "data": {
    "id": "cf161b09-6bab-4a24-9c7b-c8f223b18c09",
    "organisation": "org_example",
    "name": "Donation",
    "state": "COMPLETED",
    "type": "GENERAL",
    "platform": "STRIPE",
    "method": "CB",
    "amount": 1500,
    "devise": "eur",
    "contact": "contact_example",
    "info": {
      "prenom": "Sarah",
      "nom": "Cohen",
      "email": "sarah@example.org",
      "tel": ""
    },
    "datetime": "2026-10-16T10:00:00.000Z",
    "externalRef": "commande-1234",
    "externalMetadata": {
      "registrationId": "inscription-567",
      "eventId": "chabbat-890"
    }
  }
}
```

Exemple de paiement.refunded (champs représentatifs ; des champs propres au fournisseur peuvent également être présents) :

```json
{
  "id": "800efee9-9414-4392-98d0-2ebf6759f617",
  "type": "paiement.refunded",
  "organisation": "org_example",
  "createdAt": "2026-10-16T11:00:00.000Z",
  "attempt": 1,
  "data": {
    "id": "cf161b09-6bab-4a24-9c7b-c8f223b18c09",
    "organisation": "org_example",
    "name": "Donation",
    "state": "REFUNDED",
    "type": "GENERAL",
    "platform": "STRIPE",
    "method": "CB",
    "amount": 1500,
    "devise": "eur",
    "contact": "contact_example",
    "info": {
      "prenom": "Sarah",
      "nom": "Cohen",
      "email": "sarah@example.org",
      "tel": ""
    },
    "datetime": "2026-10-16T10:00:00.000Z",
    "externalRef": "commande-1234",
    "externalMetadata": {
      "registrationId": "inscription-567",
      "eventId": "chabbat-890"
    },
    "refund": {
      "state": "SUCCEEDED",
      "reason": "requested_by_customer",
      "updatedAt": "2026-10-16T11:00:00.000Z"
    }
  }
}
```

#### En-têtes

| En-tête | Signification |
|---|---|
| X-Unisoft-Event | Identique à body.type |
| X-Unisoft-Event-Id | Identique à body.id ; clé de déduplication |
| X-Unisoft-Delivery-Id | Identifiant de l’enregistrement de livraison pour cette destination |
| X-Unisoft-Timestamp | Secondes Unix |
| X-Unisoft-Signature | sha256= suivi du HMAC en hexadécimal minuscule |

#### Test de connectivité

Le bouton Test du back-office envoie webhook.test via la file signée habituelle, indépendamment de la liste des événements auxquels vous êtes abonné. Il ne crée aucun paiement ni remboursement. Ses données contiennent `test:true`, `triggeredBy` (identifiant d’accès administrateur ou null) et `message`. Des schémas lisibles par machine propres à chaque événement sont également disponibles sous `x-webhooks` dans openapi.json.

**Contenu multilingue (à lire avant de renseigner un champ texte).** Le contenu traduisible n’utilise PAS une correspondance `{fr:…, en:…}`. À la place :
- La valeur dans la **langue par défaut** de l’organisation (`org.language`) se trouve à la **RACINE** de l’objet — jamais sous sa propre clé de langue.
- Chaque **autre** langue activée par l’organisation (`org.languages`) est une **surcharge partielle**, indexée par son code de langue et ne contenant que les champs traduisibles.

```json
{ "label": "Restaurant", "he": { "label": "מסעדה" } }   // org default = French
```

Les clés de surcharge valides sont **dynamiques pour chaque organisation** : ses langues activées, moins la langue par défaut. L’envoi de la langue par défaut comme surcharge est rejeté (cela dupliquerait la racine) ; une langue non prise en charge est ignorée sans avertissement. Un champ absent d’une surcharge reprend la valeur de la racine.

**Modifier ou supprimer une traduction** — lors d’une mise à jour partielle (`PATCH`), l’omission d’une clé signifie *« la laisser telle quelle »*. Par conséquent :

| Corps | Effet sur la traduction `he` |
|---|---|
| `{"he": {"label": "מסעדה"}}` | créée ou remplacée |
| *(clé omise)* | laissée intacte |
| `{"he": null}` | **supprimée** (toute la surcharge `he` est retirée) |
| `{"he": {}}` | également supprimée — une surcharge vide ne contient aucune traduction |

Pour supprimer une traduction, envoyez explicitement null pour cette langue. Un objet de traduction vide est également traité comme une suppression ; omettre la langue préserve sa valeur actuelle.

**La langue par défaut est contrôlée selon l’opération, et non selon la clé.** L’envoyer comme surcharge pour l’ÉCRIRE est rejeté (`{"fr": {"label": "…"}}` dans une organisation dont le français est la langue par défaut) — la langue par défaut doit se trouver à la racine. En revanche, `{"fr": null}` est accepté : cela SUPPRIME une surcharge dans cette langue. C’est important lorsqu’une organisation change de langue par défaut — une surcharge dans la nouvelle langue par défaut persiste dans les documents et prévaut sur la valeur racine lors de l’affichage ; sa suppression doit donc rester possible. Voir le schéma `I18nOverlay`.

### Opérations

### GET /utils/uuid

Générer un UUID

`generate_uuid`

Générer un ou plusieurs UUID v4. La plupart des identifiants de ressource de cette API sont des UUID ; une intégration (ou un agent MCP/IA) a donc souvent besoin d’un nouvel identifiant valide avant de créer ou rattacher une ressource (par ex. choisir un identifiant de bloc de contenu puis écrire ce bloc). Aucune autorisation requise — toute clé valide est acceptée.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": null,
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "count",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 100,
    "default": 1
  },
  "description": "Nombre d’UUID à générer (1–100). 1 par défaut."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "uuid": {
                "type": "string",
                "format": "uuid",
                "description": "Premier UUID généré (raccourci pratique pour le cas courant count=1)."
              },
              "uuids": {
                "type": "array",
                "items": {
                  "type": "string",
                  "format": "uuid"
                },
                "description": "Tous les UUID générés."
              }
            }
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": null,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /me

Consulter la clé API, ses autorisations et son organisation

`get_me`

Lire l’identité de la clé appelante, ses autorisations accordées et son organisation, y compris defaultLanguage et enabledLanguages. Utilisez cette opération en lecture seule pour vérifier la clé et l’environnement avant toute écriture. Nécessite une clé API d’organisation valide ; aucune autorisation supplémentaire n’est requise. Le jeton global de catalogue kc_live_* ne peut pas appeler cette opération.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": null,
  "additional": []
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "apiKey": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "prefix": {
                    "type": "string"
                  },
                  "scopes": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                }
              },
              "organisation": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "shortName": {
                    "type": "string"
                  },
                  "defaultLanguage": {
                    "type": "string",
                    "description": "Langue enregistrée à la racine des objets métier multilingues."
                  },
                  "enabledLanguages": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Toutes les langues activées, y compris defaultLanguage. Les autres langues sont enregistrées sous forme de surcharges partielles."
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "Clé absente ou invalide",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": null,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /contacts

Lister les contacts

`list_contacts`

Autorisation requise : `contacts:read`. Liste/filtre les contacts de l’organisation, chacun renvoyé dans sa structure complète (identité + sous-collections). `email`/`phone` sont ici des correspondances scalaires EXACTES (pour une recherche floue de doublon, utilisez GET /contacts/search). Résultats paginés.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

```json
{
  "name": "createdAfter",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Filtre : créé après cette date (ISO 8601)."
}
```

```json
{
  "name": "updatedAfter",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Contacts modifiés après cette date uniquement."
}
```

```json
{
  "name": "email",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Correspondance exacte (en minuscules) de l’email principal."
}
```

```json
{
  "name": "phone",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Correspondance exacte du téléphone principal."
}
```

```json
{
  "name": "tag",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Filtrer par catégorie (normalisée, par ex. \"Donateur\" → DONATEUR)."
}
```

```json
{
  "name": "isLocal",
  "in": "query",
  "schema": {
    "type": "boolean"
  },
  "description": "Filtrer par indicateur de proximité « local » (true/false)."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Contact"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /contacts

Créer ou compléter un contact

`create_contact`

Autorisation requise : `contacts:write`. UPSERT INTELLIGENT : si un contact avec ce `phone` ou cet `email` (normalisé) existe déjà, il est MIS À JOUR uniquement pour remplir les champs vides — les valeurs d’identité existantes ne sont JAMAIS remplacées ; téléphones/emails/adresses/catégories/champs personnalisés secondaires sont ajoutés, et la réponse indique `created:false`. Seule une véritable insertion déclenche le webhook `contact.created`. Fournissez `?forceCreate=true` pour toujours insérer un nouveau document. Pour REMPLACER une valeur d’identité connue, utilisez plutôt PATCH /contacts/{id}. À la création, si aucun `tags` n’est fourni, la catégorie source `#API` est définie. Formats : `gender` "M"/"F"/null (jamais une civilité), `phone` tout format → E.164, `birthDate` ISO. `tags` sont des étiquettes booléennes ; `customFields` sont des paires clé/valeur typées (upsert par clé ; NUMBER/DATETIME enregistrés comme TEXT).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "forceCreate",
  "in": "query",
  "schema": {
    "type": "boolean"
  },
  "description": "true → toujours insérer un nouveau contact, même si un téléphone/email correspond à un contact existant."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContactCreateInput"
      },
      "example": {
        "firstName": "david",
        "lastName": "levy",
        "gender": "M",
        "email": "David.Levy@GMAIL.com ",
        "phone": "06 11 22 33 44",
        "tags": [
          "Donateur"
        ],
        "customFields": [
          {
            "key": "classe",
            "type": "TEXT",
            "value": "CM2"
          }
        ]
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "created": {
                "type": "boolean",
                "description": "true = un nouveau contact a été inséré ; false = un contact existant a été mis à jour en remplissant uniquement les champs vides."
              },
              "data": {
                "$ref": "#/components/schemas/Contact"
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /contacts/search

Rechercher un contact par téléphone/email (dédoublonnage)

`search_contacts`

Autorisation requise : `contacts:read`. Recherche avant création pour dédoublonner : normalise `email`/`phone` et renvoie l’unique contact correspondant (`{found, contact}`) — ce n’est PAS une liste paginée. À utiliser avant create_contact pour savoir si le contact existe déjà. Fournissez au moins `email` ou `phone`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "email",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Email à faire correspondre (normalisé)."
}
```

```json
{
  "name": "phone",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Téléphone à faire correspondre (normalisé)."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "found": {
                "type": "boolean"
              },
              "contact": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/Contact"
                  }
                ],
                "nullable": true
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "PARAMÈTRE_REQUIS",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "MISSING_QUERY"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /contacts/import/schema

Découvrir les champs et options importables

`get_contact_import_schema`

Autorisation requise : `contacts:read`. Guide d’importation auto-descriptif — appelez-le EN PREMIER pour découvrir chaque champ importable (avec ses alias pour associer les colonnes du tableur) et les options disponibles, puis exécutez normalisation → recherche → import dryRun → import. Renvoie `fields[]` ({key, label, type, kind, multi, example, description, aliases[]}) et `options` (dedupStrategy, defaultPhoneCountry, dateFormat, requireContact, applyTags). Reprend l’étape d’association des colonnes de la page ImportPage de l’admin.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:read",
  "additional": []
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/ContactImportSchema"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /contacts/normalize

Normaliser les lignes d’un tableur (sans enregistrement)

`normalize_contacts`

Autorisation requise : `contacts:read`. Normalisation PURE des lignes de tableur non nettoyées, colonne par colonne — aucune base de données ni donnée d’organisation n’est modifiée. Pour chaque ligne, nettoie phone→E.164 (+ pays détecté), email, birthDate→ISO et civilité→`gender` "M"/"F", et signale les `issues`. ÉTAPE 2 du parcours d’import Excel (après get_contact_import_schema ; ensuite lookup_contacts, puis import_contacts dryRun). Exemple : `{phone:"06 12 34 56 78", birthDate:"15/03/1990", gender:"Mme", firstName:"sarah", category:"Séder night"}` → `{phone:{e164:"+33612345678", country:"FR", valid:true}, birthDate:{value:"1990-03-15", valid:true}, gender:"F", firstName:"Sarah", tags:["SEDER_NIGHT"]}`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:read",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContactNormalizeInput"
      },
      "example": {
        "rows": [
          {
            "phone": "06 12 34 56 78",
            "birthDate": "15/03/1990",
            "gender": "Mme",
            "firstName": "sarah",
            "category": "Séder night"
          }
        ],
        "defaultPhoneCountry": "FR"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/NormalizeResult"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:read",
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### POST /contacts/lookup

Rechercher les correspondances par lot (sans écriture)

`lookup_contacts`

Autorisation requise : `contacts:read`. Pour chaque élément, recherche le contact correspondant de l’organisation SANS rien écrire (un contact supprimé logiquement n’est jamais réactivé). ÉTAPE 3 du parcours d’import Excel : exécutez après normalize_contacts pour repérer les lignes déjà présentes (`matchedContactId`) avant l’import.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:read",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContactLookupInput"
      },
      "example": {
        "items": [
          {
            "phone": "+33611223344"
          },
          {
            "email": "david.levy@gmail.com"
          }
        ],
        "defaultPhoneCountry": "FR"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/LookupResult"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:read",
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### POST /contacts/import

Importer des contacts en masse (simulation + import réel)

`import_contacts`

Autorisation requise : `contacts:write`. Upsert en masse de 500 lignes maximum (500+ → 400 IMPORT_TOO_LARGE ; répartissez vous-même le fichier). ÉTAPE 4 du parcours Excel : appelez d’ABORD avec `dryRun:true` pour obtenir le PLAN par ligne (`report.lines[].action` = create/update/skip/error + `issues`), SANS rien enregistrer ; corrigez les lignes signalées `error`, puis rappelez avec `dryRun:false`. `options.dedupStrategy` = skip|update|create (update par défaut). Exemple de simulation `{contacts:[{__row:2, lastName:"cohen", phone:"061122", birthDate:"32/13/1990"}], dryRun:true}` → `report.lines:[{row:2, action:"error", issues:[{field:"phone", reason:"INVALID_PHONE", severity:"error"}, {field:"birthDate", reason:"INVALID_DATE", severity:"error"}]}]`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContactImportInput"
      },
      "example": {
        "contacts": [
          {
            "__row": 2,
            "firstName": "sarah",
            "lastName": "cohen",
            "phone": "06 12 34 56 78",
            "birthDate": "15/03/1990"
          }
        ],
        "options": {
          "dedupStrategy": "update",
          "applyTags": [
            "Import 2026"
          ]
        },
        "dryRun": true
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/ImportResult"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "IMPORT_TROP_VOLUMINEUX",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "IMPORT_TOO_LARGE"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /contacts/{id}

Obtenir un contact

`get_contact`

Autorisation requise : `contacts:read`. Renvoie le contact complet (identité + addresses/secondaryPhones/secondaryEmails/tags/customFields/familyLinks). Renvoie 404 (jamais 403) si l’identifiant appartient à une autre organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Contact"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_INTROUVABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /contacts/{id}

Modifier l’identité d’un contact (remplacement explicite)

`update_contact`

Autorisation requise : `contacts:write`. REMPLACEMENT EXPLICITE des champs d’identité (liste autorisée + nouvelle normalisation) — contrairement à create_contact, cette opération REMPLACE la valeur enregistrée. Les sous-collections (téléphones/emails/adresses secondaires, catégories, customFields) ne sont PAS modifiées — utilisez les opérations dédiées aux sous-ressources. Une chaîne vide ("") signifie « ne pas modifier » (ajout uniquement : l’identité n’est jamais effacée). Une valeur invalide pour `email`, `phone` ou `birthDate` entraîne une erreur 400.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContactUpdateInput"
      },
      "example": {
        "lastName": "LEVY",
        "gender": "M",
        "email": "d.levy@pro.com"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "data": {
                "$ref": "#/components/schemas/Contact"
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "INVALID_EMAIL, INVALID_PHONE ou INVALID_DATE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INVALID_EMAIL, INVALID_PHONE or INVALID_DATE"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_INTROUVABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /contacts/{id}/addresses

Ajouter une adresse

`add_contact_address`

Autorisation requise : `contacts:write`. Ajoute une adresse : PRINCIPALE si le contact n’en possède aucune (ou si `main:true`), sinon adresse SECONDAIRE dédoublonnée (avec identifiant stable, modifiable ensuite).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContactAddressInput"
      },
      "example": {
        "label": "Bureau",
        "type": "PRO",
        "address": "12 rue de la Paix",
        "postalCode": "75002",
        "city": "Paris"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "data": {
                "$ref": "#/components/schemas/Contact"
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ADRESSE_MANQUANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "MISSING_ADDRESS"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_INTROUVABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### PATCH /contacts/{id}/addresses/{addressId}

Modifier une adresse secondaire

`update_contact_address`

Autorisation requise : `contacts:write`. Fusionne les champs fournis dans l’adresse SECONDAIRE désignée par `addressId` (UUID provenant de `adresses[].id`). Seuls les champs fournis sont modifiés. L’adresse PRINCIPALE n’a pas d’identifiant et ne peut pas être modifiée ici — utilisez PATCH /contacts/{id} ou POST /contacts/{id}/addresses avec main:true. 404 ADDRESS_NOT_FOUND si l’identifiant ne désigne pas une adresse secondaire de ce contact.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

```json
{
  "name": "addressId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Identifiant de l’adresse secondaire (issu de `adresses[].id`)."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContactAddressPatchInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "data": {
                "$ref": "#/components/schemas/Contact"
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_NOT_FOUND ou ADDRESS_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND or ADDRESS_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /contacts/{id}/phones

Ajouter un téléphone secondaire

`add_contact_phone`

Autorisation requise : `contacts:write`. Ajoute un téléphone SECONDAIRE (E.164, après dédoublonnage). Le téléphone principal se définit via create_contact / update_contact. 400 INVALID_PHONE si le numéro ne peut pas être analysé.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContactPhoneInput"
      },
      "example": {
        "phone": "06 98 76 54 32",
        "phoneCountry": "FR"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "data": {
                "$ref": "#/components/schemas/Contact"
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "INVALID_PHONE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INVALID_PHONE"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_INTROUVABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### POST /contacts/{id}/emails

Ajouter un email secondaire

`add_contact_email`

Autorisation requise : `contacts:write`. Ajoute un email SECONDAIRE (après dédoublonnage). L’email principal se définit via create_contact / update_contact. 400 INVALID_EMAIL si l’email est invalide.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContactEmailInput"
      },
      "example": {
        "email": "perso@gmail.com"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "data": {
                "$ref": "#/components/schemas/Contact"
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "INVALID_EMAIL",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INVALID_EMAIL"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_INTROUVABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### POST /contacts/{id}/tags

Ajouter une ou plusieurs catégories

`add_contact_tags`

Autorisation requise : `contacts:write`. Ajoute une ou plusieurs catégories (idempotent — une nouvelle attribution ne fait rien). Chacune est normalisée (majuscules, sans accents, espaces→`_`, par ex. "Séder night" → SEDER_NIGHT). Une catégorie est une étiquette booléenne — PAS un champ personnalisé clé/valeur (voir POST /contacts/{id}/custom-fields).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContactTagsInput"
      },
      "example": {
        "tags": [
          "Donateur régulier",
          "Séder night"
        ]
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "data": {
                "$ref": "#/components/schemas/Contact"
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "CATÉGORIES_MANQUANTES",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "MISSING_TAGS"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_INTROUVABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### DELETE /contacts/{id}/tags/{tag}

Retirer une catégorie

`remove_contact_tag`

Autorisation requise : `contacts:write`. Retire UNE catégorie du contact (sans effet si elle est absente). `tag` est une chaîne libre (encodez `#FORM` dans l’URL) ; elle est normalisée de la même façon qu’à l’ajout.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

```json
{
  "name": "tag",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  },
  "description": "Catégorie à retirer (encodée pour l’URL ; normalisée côté serveur)."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "data": {
                "$ref": "#/components/schemas/Contact"
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_INTROUVABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /contacts/{id}/custom-fields

Définir des champs personnalisés (upsert par clé)

`set_contact_custom_fields`

Autorisation requise : `contacts:write`. Met à jour les champs personnalisés typés PAR CLÉ (réécrire la même clé met à jour le champ existant unique, sans doublon). `override` (true par défaut — modification explicite) remplace la valeur ; false ne remplit que les champs vides. `type` est réduit à TEXT/DATE/BOOL — NUMBER/DATETIME sont enregistrés comme TEXT. Les champs personnalisés sont distincts des catégories.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContactCustomFieldsInput"
      },
      "example": {
        "customFields": [
          {
            "key": "classe",
            "type": "TEXT",
            "value": "CM2"
          },
          {
            "key": "casher",
            "type": "BOOL",
            "value": true
          }
        ]
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "data": {
                "$ref": "#/components/schemas/Contact"
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "CHAMPS_PERSONNALISÉS_MANQUANTS",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "MISSING_CUSTOM_FIELDS"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_INTROUVABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### DELETE /contacts/{id}/custom-fields/{key}

Supprimer un champ personnalisé

`remove_contact_custom_field`

Autorisation requise : `contacts:write`. Supprime un champ personnalisé par clé (insensible à la casse et au séparateur : `_` et `-` sont équivalents). Sans effet si le champ est absent.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

```json
{
  "name": "key",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  },
  "description": "Clé du champ à supprimer (encodée pour l’URL ; insensible à la casse/au séparateur)."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "data": {
                "$ref": "#/components/schemas/Contact"
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_INTROUVABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /contacts/{id}/family

Ajouter un lien familial

`add_contact_family_link`

Autorisation requise : `contacts:write`. Ajoute un lien familial BIDIRECTIONNEL entre ce contact et `relatedContactId` (le lien inverse est ajouté automatiquement). `relatedContactId` DOIT appartenir à la même organisation (sinon 404 — aucun oracle inter-organisations). 400 UNKNOWN_RELATIONSHIP pour une valeur `relationship` hors énumération ; 400 SELF_LINK si le lien cible le contact lui-même.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContactFamilyLinkInput"
      },
      "example": {
        "relationship": "PARENT",
        "relatedContactId": "b3f1c2d4-5678-49ab-8cde-0123456789ab"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "data": {
                "$ref": "#/components/schemas/Contact"
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "UNKNOWN_RELATIONSHIP ou SELF_LINK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "UNKNOWN_RELATIONSHIP or SELF_LINK"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_NOT_FOUND ou RELATED_CONTACT_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND or RELATED_CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### DELETE /contacts/{id}/family/{relatedContactId}

Supprimer un lien familial

`remove_contact_family_link`

Autorisation requise : `contacts:write`. Supprime le lien familial (et son inverse) entre ce contact et `relatedContactId`. `?relationship` précise quel lien supprimer. `relatedContactId` doit appartenir à l’organisation (sinon 404).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

```json
{
  "name": "relatedContactId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Identifiant du contact associé."
}
```

```json
{
  "name": "relationship",
  "in": "query",
  "required": true,
  "schema": {
    "type": "string",
    "enum": [
      "SPOUSE",
      "PARENT",
      "CHILD",
      "SIBLING",
      "GRANDPARENT",
      "GRANDCHILD",
      "IN_LAW",
      "EX",
      "COUSIN",
      "FRIEND"
    ]
  },
  "description": "Lien familial à supprimer (OBLIGATOIRE — son omission renvoie 400 UNKNOWN_RELATIONSHIP)."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "data": {
                "$ref": "#/components/schemas/Contact"
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "UNKNOWN_RELATIONSHIP",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "UNKNOWN_RELATIONSHIP"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_NOT_FOUND ou RELATED_CONTACT_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND or RELATED_CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /contacts/{id}/children

Ajouter un enfant

`add_contact_child`

Autorisation requise : `contacts:write`. Ajoute un enfant en bas âge (sans téléphone/email) dont les parents sont ce contact et son éventuel conjoint SPOUSE détecté. Dédoublonnage par prénom parmi les enfants des parents : un enfant existant est réutilisé (`created:false`), sinon un nouveau contact enfant est créé. Un lien PARENT↔CHILD est créé automatiquement. Exemple `{firstName:"Rivka", birthDate:"2015-09-01"}`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContactChildInput"
      },
      "example": {
        "firstName": "Rivka",
        "birthDate": "2015-09-01"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "created": {
                "type": "boolean",
                "description": "false = un enfant existant a été réutilisé."
              },
              "childId": {
                "type": "string"
              },
              "data": {
                "$ref": "#/components/schemas/Contact"
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "MISSING_FIRST_NAME",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "MISSING_FIRST_NAME"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_INTROUVABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /contacts/{id}/interactions

Lister les interactions d’un contact

`list_contact_interactions`

Autorisation requise : `contacts:read`. Renvoie les interactions consignées (appels, visites, notes) pour ce contact, de la plus récente à la plus ancienne, avec pagination par curseur. Une interaction est une entrée `contact_activity` — distincte d’un champ personnalisé ou d’une catégorie.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ContactInteraction"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_INTROUVABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /contacts/{id}/interactions

Consigner une interaction

`add_contact_interaction`

Autorisation requise : `contacts:write`. Consigne un échange avec le contact (appel, visite, note). `type` est obligatoire — pour rester cohérent, réutilisez une valeur de GET /contacts/{id}/interactions/types. Exemple `{type:"Appel", content:"Rappelé pour la campagne de Pessah", actions:["Discussion"]}`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContactInteractionInput"
      },
      "example": {
        "type": "Appel",
        "content": "Rappelé pour la campagne de Pessah",
        "actions": [
          "Discussion"
        ]
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "data": {
                "$ref": "#/components/schemas/ContactInteraction"
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "MISSING_TYPE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "MISSING_TYPE"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_INTROUVABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /contacts/{id}/interactions/types

Lister les types d’interaction

`list_contact_interaction_types`

Autorisation requise : `contacts:read`. Renvoie les libellés distincts de `type` déjà utilisés dans l’organisation (ainsi que les valeurs courantes par défaut comme « Appel », « Visite »). Choisissez l’un d’eux lors de la consignation pour assurer la cohérence CRM et éviter les libellés presque identiques.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "data": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_INTROUVABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /contacts/{id}/documents

Lister les documents d’un contact

`list_contact_documents`

Autorisation requise : `contacts:read`. Fichiers associés au contact (reçus, scans de pièce d’identité, mandats signés…), du plus récent au plus ancien. Chacun possède un `id` (pour le supprimer), un `name`, un `filename` hébergé et une `url` de téléchargement.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "data": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/ContactDocument"
                }
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_INTROUVABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /contacts/{id}/documents

Joindre un document

`create_contact_document`

Autorisation requise : `contacts:write`. Associe un document au contact. « Téléverser d’abord, joindre ensuite » : fournissez SOIT un `filename` déjà hébergé via POST /uploads/pdf|image, SOIT une `url` http(s) réhébergée côté serveur (image/PDF uniquement). `name` facultatif pour le libellé.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContactDocumentInput"
      },
      "example": {
        "url": "https://example.com/receipt-2026.pdf",
        "name": "Reçu fiscal 2026"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "data": {
                "$ref": "#/components/schemas/ContactDocument"
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "MISSING_FILE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "MISSING_FILE"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_INTROUVABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### DELETE /contacts/{id}/documents/{docId}

Détacher un document

`delete_contact_document`

Autorisation requise : `contacts:write`. Retire un document du contact par son `docId` (le fichier reste hébergé). Renvoie 404 si le contact ou l’identifiant du document est inconnu ici.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "contacts:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

```json
{
  "name": "docId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Identifiant du document renvoyé par GET /contacts/{id}/documents."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "data": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "deleted": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "DOCUMENT_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "DOCUMENT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "contacts:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /paiements

Lister les paiements

`list_paiements`

Autorisation requise : `paiements:read`. Liste uniquement les paiements COMPLETED ou REFUNDED non supprimés, dans le périmètre de l’organisation et de la clé API. `externalRef` utilise une égalité exacte, sensible à la casse, et se combine avec les autres filtres ; plusieurs paiements peuvent partager cette valeur. Sans correspondance, renvoie une liste paginée vide. Les tentatives INIT, en attente et échouées restent exclues, même avec externalRef.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "paiements:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

```json
{
  "name": "createdAfter",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Filtre : créé après cette date (ISO 8601)."
}
```

```json
{
  "name": "createdBefore",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Filtre : créé avant cette date (ISO 8601)."
}
```

```json
{
  "name": "type",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "GENERAL | SERVICE | CAISSE | DETTE | FORM"
}
```

```json
{
  "name": "platform",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "STRIPE | PAYGREEN | ..."
}
```

```json
{
  "name": "contactId",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "externalRef",
  "in": "query",
  "schema": {
    "type": "string",
    "minLength": 1,
    "maxLength": 255,
    "pattern": "\\S",
    "example": "commande-1234",
    "description": "Référence facultative dans votre système. Non vide, enregistrée telle quelle ; correspondance exacte sensible à la casse. Non unique et ne constitue PAS une clé d’idempotence. À distinguer de externalId (dédoublonnage à l’import). Renvoyée lors de la lecture des paiements et dans les webhooks de paiement si elle est fournie. Héritée par les paiements récurrents."
  },
  "description": "Référence externe exacte, sensible à la casse ; encodez la valeur dans l’URL. Exemple : ?externalRef=commande-1234. Une valeur répétée/structurée ou invalide renvoie 400 INVALID_EXTERNAL_REF."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Paiement"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "INVALID_EXTERNAL_REF",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INVALID_EXTERNAL_REF"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "paiements:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /paiements

Créer un lien de paiement autonome

`create_paiements`

Autorisation requise : `paiements:write`. Crée un enregistrement de paiement à l’état INIT et renvoie l’URL de la page de paiement hébergée (ou `clientSecret` pour les fournisseurs intégrés). L’entité cible (`typeId`) doit appartenir à l’organisation de la clé API. `config.organisation` est forcée côté serveur — toute valeur fournie par l’appelant est ignorée. `config` est validée avant traitement : `config.montant` doit être un nombre fini > 0 en unités majeures et ≤ 1000000 (sauf type SERVICE, dont le montant provient du service) ; `config.service` n’est accepté qu’avec type SERVICE ; chaque entrée `config.dettes[]` doit appartenir à votre organisation et avoir un montant fini > 0.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "paiements:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentRequest"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/PaymentResponse"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "MISSING_CONFIG / INVALID_MONTANT / MONTANT_TOO_LARGE / SERVICE_NOT_ALLOWED / INVALID_DETTES / INVALID_EXTERNAL_REF / INVALID_EXTERNAL_METADATA",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "MISSING_CONFIG / INVALID_MONTANT / MONTANT_TOO_LARGE / SERVICE_NOT_ALLOWED / INVALID_DETTES / INVALID_EXTERNAL_REF / INVALID_EXTERNAL_METADATA"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "ORG_NOT_FOUND / TARGET_NOT_FOUND / DETTE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ORG_NOT_FOUND / TARGET_NOT_FOUND / DETTE_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "paiements:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### POST /paiements/import

Importer un paiement déjà encaissé

`import_paiement`

Autorisation requise : `paiements:write`. Enregistre un don encaissé AILLEURS (chèque, virement, espèces, ancien logiciel, autre plateforme) comme paiement historique/comptable — enregistré avec `imported:true` et `state:"COMPLETED"`. Il alimente statistiques, compteurs de campagne, CRM et conversions de devise, mais aucun reçu/cerfa n’est émis de nouveau. Équivalent unitaire et validé des importateurs CLI en masse. Utilisez `POST /paiements` (et non cette opération) pour qu’un donateur paie en ligne maintenant. Idempotent si `externalId` est fourni (migration relançable sans risque).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "paiements:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaiementImportInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Paiement"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "INVALID_AMOUNT / INVALID_METHOD / ASSOC_NOT_FOUND / INVALID_EXTERNAL_REF / INVALID_EXTERNAL_METADATA",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INVALID_AMOUNT / INVALID_METHOD / ASSOC_NOT_FOUND / INVALID_EXTERNAL_REF / INVALID_EXTERNAL_METADATA"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_NOT_FOUND / TARGET_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND / TARGET_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": false,
  "x-unisoft-scope": "paiements:write"
}
```

### GET /paiements/{id}

Obtenir un paiement

`get_paiement`

Autorisation requise : `paiements:read`. Le détail reste disponible à l’état REFUND_PENDING pour inspecter un remboursement non confirmé. Vérifiez auprès de Nedarim tout remboursement Nedarim non confirmé avant de réessayer.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "paiements:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Paiement"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "paiements:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /paiements/{id}/refund

Rembourser un paiement

`refund_paiement`

Autorisation requise : `paiements:write`. Déclenche un remboursement intégral auprès du fournisseur de paiement. Fournisseurs pris en charge : Stripe, Stripe externe, iPay, Nedarim et PayGreen. Le paiement doit appartenir à l’organisation de la clé API, être terminé, ne pas être groupé ni déjà remboursé. Nedarim conserve le reçu d’origine et émet un reçu négatif. Une réponse Nedarim ou PayGreen non confirmée laisse le paiement à l’état REFUND_PENDING : vérifiez auprès du fournisseur avant de demander un autre remboursement. PayGreen vérifie la référence de commande, la boutique, le montant, la devise et les fonds encaissés avant de demander un remboursement complet. Cette opération financière est irréversible.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "paiements:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentRefundRequest"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Remboursement accepté",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentRefundResponse"
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "INVALID_REASON / INVALID_STATE / GROUPED_PAIEMENT / ALREADY_REFUNDED / REFUND_FAILED / NEDARIM_REFUND_UNCONFIRMED. Si pending vaut true, vérifiez la transaction dans Nedarim avant de réessayer.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PaymentRefundResponse"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "PAIEMENT_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "PAIEMENT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

##### HTTP 405

```json
{
  "description": "METHOD_NOT_ALLOWED",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "METHOD_NOT_ALLOWED"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "paiements:write",
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": true,
    "idempotent": false,
    "warn": true
  }
}
```

### GET /forms

Lister les formulaires

`list_forms`

Autorisation requise : `forms:read`. Liste les formulaires de l’organisation (champs succincts). Résultats paginés.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "forms:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

```json
{
  "name": "active",
  "in": "query",
  "schema": {
    "type": "boolean"
  },
  "description": "Filtrer par état actif."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FormDefinition"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "forms:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /forms

Créer un formulaire

`create_form`

Autorisation requise : `forms:write`. Crée une DÉFINITION de formulaire à partir de l’objet métier de l’éditeur. La transpilation de `additionalFields` et l’enregistrement de `products` sont gérés côté serveur. Renvoie le formulaire créé dans la structure de l’éditeur.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "forms:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/FormInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FormInput"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "forms:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /forms/{id}

Obtenir la définition d’un formulaire (produits, calendriers, contenu)

`get_form`

Autorisation requise : `forms:read`. Renvoie la même charge utile que le site public utilise pour afficher le formulaire (`content` transpilé), limitée à l’organisation de la clé API. Pour MODIFIER un formulaire, consultez plutôt `/forms/{id}/edit`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "forms:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FormDefinition"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "forms:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /forms/{id}

Modifier un formulaire

`update_form`

Autorisation requise : `forms:write`. Mise à jour partielle d’une DÉFINITION de formulaire (objet métier de l’éditeur). Seuls les champs fournis sont modifiés ; omettez `products`/`additionalFields` pour les laisser tels quels, envoyez-les pour remplacer l’ensemble. Renvoie le formulaire modifié dans la structure de l’éditeur.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "forms:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/FormUpdateInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FormInput"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "forms:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /forms/{id}/edit

Obtenir un formulaire dans le format de l’éditeur

`get_form_edit`

Autorisation requise : `forms:read`. Renvoie l’objet métier de l’éditeur (produits intégrés, `additionalFields` reconstitués) — exactement la structure acceptée par `POST /forms` et `PATCH /forms/{id}`. Lisez cette ressource avant toute modification.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "forms:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FormInput"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "forms:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /forms-submit

Lister les soumissions de formulaire

`list_forms_submit`

Autorisation requise : `forms_submit:read`

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "forms_submit:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

```json
{
  "name": "createdAfter",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Filtre : créé après cette date (ISO 8601)."
}
```

```json
{
  "name": "createdBefore",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Filtre : créé avant cette date (ISO 8601)."
}
```

```json
{
  "name": "formId",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "state",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "SUBMIT",
      "VALIDE",
      "INVALIDE"
    ]
  },
  "description": "Filtrer par état de décision. SUBMIT = décision en attente."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FormSubmit"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "forms_submit:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /forms-submit

Soumettre un formulaire

`create_forms_submit`

Autorisation requise : `forms_submit:write`. Crée un document `forms_submit` et applique les mêmes effets secondaires que le site public (synchronisation CRM du contact, totaux, codes promotionnels, notifications, lien de paiement). Si un paiement est requis, `url` dans la réponse renvoie vers la page de paiement hébergée. Le mode modification (`data.extra.editId`) n’est pas pris en charge par cette opération.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "forms_submit:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubmitRequest"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/SubmitResponse"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "MISSING_FORM_ID ou EDIT_MODE_NOT_SUPPORTED",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "MISSING_FORM_ID or EDIT_MODE_NOT_SUPPORTED"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FORM_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "FORM_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "forms_submit:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### POST /forms-submit/with-payment

Soumettre un formulaire et créer le lien de paiement en un seul appel

`create_forms_submit_with_payment`

Autorisations requises : `forms_submit:write` ET `paiements:write`. Même comportement que `POST /forms-submit` — opération pratique rendant explicites les autorisations requises lorsque l’appelant sait qu’un paiement est attendu. L’URL de paiement est renvoyée dans `url`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "forms_submit:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SubmitRequest"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/SubmitResponse"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "MISSING_FORM_ID ou EDIT_MODE_NOT_SUPPORTED",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "MISSING_FORM_ID or EDIT_MODE_NOT_SUPPORTED"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPES",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPES"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FORM_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "FORM_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "forms_submit:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /forms-submit/{id}

Obtenir une soumission de formulaire

`get_forms_submit`

Autorisation requise : `forms_submit:read`

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "forms_submit:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FormSubmit"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "forms_submit:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /forms-submit/{id}/validate

Accepter une soumission (⚠️ envoie un email à son auteur)

`validate_submission`

Autorisation requise : `forms_submit:validate`. Définit la soumission à l’état VALIDE et ENVOIE un email de confirmation à son auteur — effet réel, d’où cette autorisation dédiée. Idempotent : renvoie `already:true` si la soumission était déjà VALIDE.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "forms_submit:validate",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "forms_submit:validate",
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": true,
    "idempotent": false,
    "warn": true
  }
}
```

### POST /forms-submit/{id}/invalidate

Refuser une soumission (sans email)

`invalidate_submission`

Autorisation requise : `forms_submit:validate`. Définit la soumission à l’état INVALIDE. N’envoie d’email à personne. Idempotent : renvoie `already:true` si la soumission était déjà INVALIDE.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "forms_submit:validate",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "forms_submit:validate",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /abonnements

Lister les abonnements

`list_abonnements`

Autorisation requise : `abonnements:read`

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "abonnements:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

```json
{
  "name": "active",
  "in": "query",
  "schema": {
    "type": "boolean"
  }
}
```

```json
{
  "name": "contactId",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Abonnement"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "abonnements:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /abonnements/{id}

Obtenir un abonnement

`get_abonnement`

Autorisation requise : `abonnements:read`

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "abonnements:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Abonnement"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "abonnements:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /events

Lister les événements autonomes

`list_events`

Autorisation requise : `events:read`. Liste les sessions d’événement AUTONOMES de l’organisation (« parcours d’événement »), chacune avec ses liens publics de formulaire/don. Les groupes à sessions multiples et les groupes système (par ex. Shabbat) sont exclus. Tri par date de début, de la plus récente à la plus ancienne. Résultats paginés.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "events:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Event"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "events:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /events/{id}

Obtenir un événement autonome

`get_event`

Autorisation requise : `events:read`. Renvoie un événement autonome par identifiant (avec ses liens publics). Renvoie 404 s’il ne s’agit pas d’un événement autonome de l’organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "events:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Event"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "events:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /promesses

Lister les promesses de don

`list_promesses`

Autorisation requise : `promesses:read`. Liste les promesses de don de l’organisation, enrichies des champs calculés `payed`/`reste`/`status` et du nom du donateur. Exclut les promesses annulées sauf si `includeCanceled=true`. Résultats paginés, de la plus récente à la plus ancienne.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "promesses:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

```json
{
  "name": "contactId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Filtrer par identifiant du contact donateur."
}
```

```json
{
  "name": "typeId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Filtrer par identifiant du livret/de la campagne associé(e)."
}
```

```json
{
  "name": "occasion",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Filtrer par occasion (correspondance exacte)."
}
```

```json
{
  "name": "includeCanceled",
  "in": "query",
  "schema": {
    "type": "boolean"
  },
  "description": "Inclure les promesses annulées (false par défaut)."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Promesse"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "promesses:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /promesses

Créer une promesse de don

`create_promesse`

Autorisation requise : `promesses:write`. Crée une promesse pour un contact de l’organisation. `montant` est exprimé en unités MAJEURES de la devise (par ex. 50 = 50 €), PAS en centimes. La devise est toujours déduite de `assoc` (MAIN par défaut) et ne peut pas être remplacée. `organisation` est imposée côté serveur.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "promesses:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PromesseCreate"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Promesse"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "INVALID_MONTANT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INVALID_MONTANT"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "CONTACT_INTROUVABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "promesses:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /promesses/{id}

Obtenir une promesse de don

`get_promesse`

Autorisation requise : `promesses:read`. Renvoie la promesse avec les valeurs `payed`/`reste`/`status` recalculées.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "promesses:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Promesse"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "promesses:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /promesses/{id}

Modifier une promesse de don

`update_promesse`

Autorisation requise : `promesses:write`. Modifie n’importe quel sous-ensemble des champs modifiables de la promesse. `assoc`/`devise` ne sont PAS modifiables (fixés à la création). Les champs calculés (reste/payed/status) ne sont jamais acceptés.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "promesses:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PromesseUpdate"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Promesse"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "INVALID_MONTANT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INVALID_MONTANT"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND ou CONTACT_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND or CONTACT_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "promesses:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### DELETE /promesses/{id}

Annuler une promesse de don

`delete_promesse`

Autorisation requise : `promesses:write`. Supprime la promesse de manière logique (active=false, state=CANCELED) — elle disparaît des listes actives, mais n’est jamais supprimée physiquement.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "promesses:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "promesses:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /promesses/{id}/payment-link

Créer ou récupérer le lien de paiement d’une promesse

`create_promesse_payment_link`

Autorisation requise : `promesses:write`. Crée ou réutilise une URL de page de paiement hébergée afin que le donateur puisse honorer sa promesse. Renvoie 409 si la promesse est annulée, déjà entièrement payée ou couverte par un abonnement actif.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "promesses:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/PromessePaymentLink"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

##### HTTP 409

```json
{
  "description": "PLEDGE_FULFILLED, PLEDGE_CANCELED ou PLEDGE_COVERED",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "PLEDGE_FULFILLED, PLEDGE_CANCELED or PLEDGE_COVERED"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "promesses:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /associations

Lister les associations de l’organisation

`list_associations`

Liste les associations juridiques de l’organisation (identifiant, libellé, devise) afin de choisir le bon `assoc` lors de la création d’une promesse ou d’un paiement. Aucune autorisation requise.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": null,
  "additional": []
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Association"
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": null,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /caisses

Lister les cagnottes

`list_caisses`

Autorisation requise : `caisses:read`. Liste les cagnottes de collecte de l’organisation, chacune enrichie de `payed`/`reste`. Résultats paginés.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "caisses:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

```json
{
  "name": "active",
  "in": "query",
  "schema": {
    "type": "boolean"
  },
  "description": "Filtrer par état actif."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Caisse"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "caisses:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /caisses

Créer une cagnotte

`create_caisse`

Autorisation requise : `caisses:write`. Crée une cagnotte de collecte. `bgimage` peut être une URL http(s) (réhébergée) ou un nom de fichier hébergé. Utilisez `typeId:"AUTO"` pour une cagnotte autonome.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "caisses:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CaisseInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Caisse"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "caisses:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /caisses/{id}

Obtenir une cagnotte

`get_caisse`

Autorisation requise : `caisses:read`. Renvoie la cagnotte enrichie des sommes collectées `payed`/`reste`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "caisses:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Caisse"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "caisses:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /caisses/{id}

Modifier une cagnotte

`update_caisse`

Autorisation requise : `caisses:write`. Mise à jour partielle — seuls les champs fournis sont modifiés.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "caisses:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CaisseUpdateInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Caisse"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "caisses:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /caisses/{id}/pause

Mettre une cagnotte en pause

`pause_caisse`

Autorisation requise : `caisses:write`. Interrompt l’acceptation des contributions sans archiver la cagnotte.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "caisses:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "caisses:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /caisses/{id}/resume

Reprendre une cagnotte en pause

`resume_caisse`

Autorisation requise : `caisses:write`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "caisses:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "caisses:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /caisses/{id}/archive

Archiver une cagnotte

`archive_caisse`

Autorisation requise : `caisses:write`. Archive et désactive la cagnotte.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "caisses:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "caisses:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /caisses/{id}/unarchive

Désarchiver une cagnotte

`unarchive_caisse`

Autorisation requise : `caisses:write`. Restaure une cagnotte archivée (la réactive).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "caisses:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "caisses:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /caisses/{id}/delete

Désactiver une cagnotte

`delete_caisse`

Autorisation requise : `caisses:write`. Supprime logiquement la cagnotte (définit active=false). Le document est conservé.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "caisses:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "caisses:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /pages

Lister les pages

`list_pages`

Autorisation requise : `pages:read`. Liste les pages de l’organisation (champs succincts + `url` concaténée). Résultats paginés.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "pages:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

```json
{
  "name": "active",
  "in": "query",
  "schema": {
    "type": "boolean"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Page"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "pages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /pages

Créer une page

`create_page`

Autorisation requise : `pages:write`. Crée une page IA (son contenu peut ensuite être défini via PUT /pages/{id}/content). `url` est normalisée en segments de slug et doit être unique.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "pages:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PageInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Page"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "VALIDATION_ERROR ou URL_ALREADY_USED",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR or URL_ALREADY_USED"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "pages:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /pages/{id}

Obtenir une page

`get_page`

Autorisation requise : `pages:read`. Page complète, incluant son SEO (metaTitle/metaDescription/metaImage et surcharges linguistiques), `html`/`i18n` et l’indicateur `aiEditable`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "pages:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Page"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "pages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /pages/{id}

Modifier les métadonnées d’une page

`update_page`

Autorisation requise : `pages:write`. Mise à jour partielle des métadonnées (label/title/description/url/active) et du SEO de page (metaTitle/metaDescription/metaImage, avec surcharges pour les autres langues). Fonctionne sur les pages IA et anciennes sans modifier leur contenu ni leur éditeur. Les champs et traductions omis sont conservés. Les champs SEO null/vides rétablissent les valeurs par défaut du site, puis les valeurs automatiques. Les images SEO HTTP(S) sont réhébergées, traductions comprises ; un échec d’importation refuse l’écriture. L’URL de la page d’accueil est verrouillée.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "pages:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PageUpdateInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Page"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "VALIDATION_ERROR, URL_ALREADY_USED ou MAIN_PAGE_URL_LOCKED",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR or URL_ALREADY_USED or MAIN_PAGE_URL_LOCKED"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "pages:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PUT /pages/{id}/content

Définir le contenu IA (HTML) d’une page

`set_page_content`

Autorisation requise : `pages:write`. Définit le HTML de la page ; le serveur injecte les clés data-i18n et fusionne les traductions (voir PageContentInput). Refusé avec PAGE_CONTENT_NOT_EDITABLE pour les pages de l’ancien éditeur visuel.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "pages:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PageContentInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "VALIDATION_ERROR ou PAGE_CONTENT_NOT_EDITABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR or PAGE_CONTENT_NOT_EDITABLE"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "pages:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /pages/{id}/translations

Définir les traductions d’une page

`set_page_translations`

Autorisation requise : `pages:write`. Met à jour, pour une langue, les traductions des clés data-i18n existantes. Ne modifie pas le HTML. Refusé pour les anciennes pages.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "pages:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PageTranslationsInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "VALIDATION_ERROR ou PAGE_CONTENT_NOT_EDITABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR or PAGE_CONTENT_NOT_EDITABLE"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "pages:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /pages/{id}/activate

Publier une page

`activate_page`

Autorisation requise : `pages:write`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "pages:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "pages:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /pages/{id}/deactivate

Dépublier une page

`deactivate_page`

Autorisation requise : `pages:write`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "pages:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "pages:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /content-blocks

Lister les blocs de contenu

`list_content_blocks`

Autorisation requise : `content_blocks:read`. Liste les blocs de contenu de l’organisation (champs succincts). Résultats paginés. Pour savoir QUEL bloc alimente un emplacement, consultez la configuration qui le référence — par ex. `homepage.aiContentBlockId` de Travel.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "content_blocks:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ContentBlock"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "content_blocks:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /content-blocks/{id}

Obtenir un bloc de contenu

`get_content_block`

Autorisation requise : `content_blocks:read`. Bloc complet, avec `html`, `i18n` et `mainLang`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "content_blocks:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  },
  "description": "Identifiant de bloc de contenu — toute chaîne stable de votre choix (UUID recommandé ; générez-en un avec GET /utils/uuid). PUT /content-blocks/{id}/content effectue un upsert ; cet identifiant n’a donc pas besoin d’exister au préalable."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/ContentBlock"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "content_blocks:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PUT /content-blocks/{id}/content

Définir le contenu HTML d’un bloc

`set_content_block_content`

Autorisation requise : `content_blocks:write`. Définit le HTML du bloc ; le serveur injecte les clés data-i18n et fusionne les traductions (voir les règles de rédaction HTML obligatoires de ContentBlockContentInput). Upsert : si l’identifiant n’existe pas, le bloc est créé. Vous pouvez donc écrire un bloc, puis le lier à la page d’accueil Travel (`PATCH /travel/{travelId}/config/homepage` avec `aiContentBlockId`) ou à un groupe d’événements.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "content_blocks:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  },
  "description": "Identifiant de bloc de contenu — toute chaîne stable de votre choix (UUID recommandé ; générez-en un avec GET /utils/uuid). PUT /content-blocks/{id}/content effectue un upsert ; cet identifiant n’a donc pas besoin d’exister au préalable."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContentBlockContentInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "content_blocks:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /content-blocks/{id}/translations

Définir les traductions d’un bloc de contenu

`set_content_block_translations`

Autorisation requise : `content_blocks:write`. Met à jour, pour une langue, les traductions des clés data-i18n existantes. Ne modifie pas le HTML.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "content_blocks:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  },
  "description": "Identifiant de bloc de contenu — toute chaîne stable de votre choix (UUID recommandé ; générez-en un avec GET /utils/uuid). PUT /content-blocks/{id}/content effectue un upsert ; cet identifiant n’a donc pas besoin d’exister au préalable."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ContentBlockTranslationsInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "content_blocks:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /email-templates

Lister les modèles d’email

`list_email_templates`

Autorisation requise : `email_templates:read`. Liste les modèles d’email de l’organisation (champs succincts, sans html). Résultats paginés.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_templates:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EmailTemplate"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_templates:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /email-templates

Créer un modèle d’email

`create_email_template`

Autorisation requise : `email_templates:write`. Crée un modèle. `html` est facultatif (créez un modèle vide, puis remplissez-le via PUT /{id}/content). Après la création, associez son identifiant à une campagne comme email de remerciement au donateur (`campagnes.config.donorEmailTemplate`).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_templates:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EmailTemplateCreateInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EmailTemplate"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_templates:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /email-templates/{id}

Obtenir un modèle d’email

`get_email_template`

Autorisation requise : `email_templates:read`. Modèle complet, avec `html`, `design` et `assets`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_templates:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EmailTemplate"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_templates:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /email-templates/{id}

Renommer un modèle d’email

`update_email_template`

Autorisation requise : `email_templates:write`. Renomme le modèle (métadonnées uniquement ; utilisez PUT /{id}/content pour modifier le HTML).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_templates:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EmailTemplateRenameInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_templates:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### DELETE /email-templates/{id}

Supprimer un modèle d’email

`delete_email_template`

Autorisation requise : `email_templates:write`. Supprime logiquement le modèle.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_templates:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_templates:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

### PUT /email-templates/{id}/content

Définir le contenu HTML d’un modèle

`update_email_template_content`

Autorisation requise : `email_templates:write`. Définit le HTML du modèle (régénère l’aperçu, au mieux). Respectez les règles de compatibilité des clients de messagerie de EmailTemplateContentInput.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_templates:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EmailTemplateContentInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EmailTemplate"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_templates:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /galleries

Lister les galeries photo

`list_galleries`

Autorisation requise : `galleries:read`. Liste les galeries actives de l’organisation (sans `images[]` ; chacune contient `nbImages` et une image de couverture). Résultats paginés. Filtrez avec `?category` (catégorie), `?search` (recherche plein texte) ou `?contact` (identifiant d’un contact CRM).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "galleries:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

```json
{
  "name": "category",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Filtrer les galeries ayant cette catégorie."
}
```

```json
{
  "name": "search",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Recherche plein texte dans les galeries."
}
```

```json
{
  "name": "contact",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Filtrer les galeries associées à cet identifiant de contact CRM."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Gallery"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "galleries:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /galleries

Créer une galerie photo

`create_gallery`

Autorisation requise : `galleries:write`. Crée un album vide. Ajoutez ensuite des photos via POST /galleries/{id}/images.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "galleries:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/GalleryCreateInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Gallery"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "galleries:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /galleries/categories

Lister les catégories de galerie

`list_gallery_categories`

Autorisation requise : `galleries:read`. Renvoie les catégories distinctes utilisées dans les galeries de l’organisation (utile pour renseigner le filtre `category` ou réutiliser une catégorie existante lors d’une création/modification).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "galleries:read",
  "additional": []
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "galleries:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /galleries/{id}

Obtenir une galerie photo

`get_gallery`

Autorisation requise : `galleries:read`. Renvoie les métadonnées de l’album, `nbImages` et l’image de couverture (PAS la liste complète des images — utilisez GET /galleries/{id}/images).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "galleries:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Gallery"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "galleries:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /galleries/{id}

Modifier une galerie photo

`update_gallery`

Autorisation requise : `galleries:write`. Mise à jour partielle des métadonnées de l’album (nom/description/catégories/compte/contact). Les images se gèrent via les opérations dédiées.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "galleries:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/GalleryUpdateInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Gallery"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "galleries:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### DELETE /galleries/{id}

Supprimer une galerie photo

`delete_gallery`

Autorisation requise : `galleries:write`. Supprime logiquement l’album (masqué du site et des listes ; le document est conservé).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "galleries:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "galleries:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /galleries/{id}/images

Lister les images d’une galerie

`list_gallery_images`

Autorisation requise : `galleries:read`. Renvoie une page de noms de fichiers image de l’album ("md5.ext") et leurs URL publiques dans `meta.imageUrls`. Pagination par page : `?page` (indexée à partir de 1) et `?limit` (30 par défaut).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "galleries:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

```json
{
  "name": "page",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "default": 1
  }
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 30
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "galleries:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /galleries/{id}/images

Ajouter des images à une galerie

`add_gallery_images`

Autorisation requise : `galleries:write`. Ajoute des images à l’album. Envoyez SOIT un ou plusieurs champs de fichier image multipart/form-data (5 Mo maximum chacun, image/* uniquement), SOIT un corps JSON {images:[url|filename]} (les URL http(s) sont réhébergées côté serveur ; les noms de fichiers "md5.ext" déjà hébergés sont joints tels quels). Les doublons sont ignorés. Un agent MCP/IA doit utiliser le format JSON avec des URL.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "galleries:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/GalleryAddImagesInput"
      }
    },
    "multipart/form-data": {
      "schema": {
        "type": "object",
        "properties": {
          "file": {
            "type": "string",
            "format": "binary",
            "description": "Un ou plusieurs fichiers image (répétez le champ pour en envoyer plusieurs)."
          }
        }
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "added": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "addedUrls": {
                "type": "array",
                "items": {
                  "type": "string",
                  "format": "uri"
                }
              },
              "nbImages": {
                "type": "integer"
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "galleries:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### DELETE /galleries/{id}/images

Retirer des images d’une galerie

`remove_gallery_images`

Autorisation requise : `galleries:write`. Détache les images de l’album par leur nom de fichier hébergé. Les fichiers physiques ne sont pas supprimés.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "galleries:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/GalleryRemoveImagesInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "removed": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "nbImages": {
                "type": "integer"
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "galleries:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /galleries/{id}/images/reorder

Réorganiser les images d’une galerie

`reorder_gallery_images`

Autorisation requise : `galleries:write`. Définit l’ordre d’affichage des images de l’album. `order` doit être une permutation des noms de fichiers actuels ; les images omises sont ajoutées à la fin dans leur ordre actuel (aucune n’est perdue). La première image devient la couverture.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "galleries:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/GalleryReorderImagesInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "images": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "galleries:write",
  "x-unisoft-mcp": {
    "category": "reorder",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /campaigns

Lister les campagnes

`list_campaigns`

Autorisation requise : `messages:read`. Liste les campagnes de l’organisation avec leurs statistiques de livraison. Résultats paginés. Filtrez avec `?state` (INIT|VALIDATE|FINISHED) ou `?type`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

```json
{
  "name": "state",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "INIT",
      "VALIDATE",
      "FINISHED"
    ]
  }
}
```

```json
{
  "name": "type",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Campaign"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /campaigns

Créer une campagne (brouillon)

`create_campaign`

Autorisation requise : `messages:write`. Crée une campagne à l’état INIT (brouillon). N’effectue PAS l’envoi — utilisez POST /{id}/send. Le ciblage est exclusif (allContact | staredOnly | categories).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "messages:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Campaign"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "messages:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /campaigns/sms/available

Consulter le quota SMS restant

`get_sms_quota`

Autorisation requise : `messages:read`. Renvoie le nombre de crédits SMS restants de l’organisation (utile avant l’envoi d’une campagne SMS).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": []
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "total": {
                "type": "integer"
              }
            }
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /campaigns/{id}

Obtenir une campagne

`get_campaign`

Autorisation requise : `messages:read`. Campagne complète, avec ses statistiques de livraison.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Campaign"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /campaigns/{id}

Modifier une campagne en brouillon

`update_campaign`

Autorisation requise : `messages:write`. Modifie une campagne uniquement tant qu’elle est à l’état INIT (brouillon). Renvoie 409 si elle a déjà été envoyée.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "messages:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Campaign"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

##### HTTP 409

```json
{
  "description": "CAMPAIGN_NOT_EDITABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CAMPAIGN_NOT_EDITABLE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "messages:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### DELETE /campaigns/{id}

Supprimer une campagne

`delete_campaign`

Autorisation requise : `messages:write`. Supprime logiquement la campagne.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "messages:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "messages:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /campaigns/{id}/duplicate

Dupliquer une campagne

`duplicate_campaign`

Autorisation requise : `messages:write`. Duplique la campagne sous forme de nouveau brouillon INIT (nouvel identifiant, scheduledAt effacé, statistiques réinitialisées ; médias partagés par référence).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "messages:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Campaign"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "messages:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /campaigns/{id}/targets

Prévisualiser le nombre de destinataires

`preview_campaign_targets`

Autorisation requise : `messages:read`. Compte les destinataires correspondant au ciblage enregistré de la campagne, SANS créer de livraison. Renvoie 0 si aucun ciblage n’est défini.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/CampaignTargets"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /campaigns/{id}/send

Envoyer la campagne (envoi massif réel)

`send_campaign`

Autorisation requise : `messages:send`. **Déclenche l’envoi massif réel.** Fait passer le brouillon de INIT à VALIDATE et met en file une livraison par destinataire correspondant ; les processus envoient ensuite via WhatsApp/SMS/email. Action **irréversible**, susceptible d’entraîner des frais SMS, un risque de blocage du numéro WhatsApp (limites de débit) et des implications RGPD (messages envoyés à de vrais contacts). Prévisualisez d’abord l’audience avec POST /{id}/targets. Idempotent : une campagne déjà envoyée (state ≠ INIT) renvoie 409.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "messages:send",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "data": {
                "type": "object",
                "properties": {
                  "state": {
                    "type": "string"
                  },
                  "targets": {
                    "type": "integer"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

##### HTTP 409

```json
{
  "description": "CAMPAIGN_ALREADY_SENT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CAMPAIGN_ALREADY_SENT"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "messages:send",
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": true,
    "idempotent": false,
    "warn": true
  }
}
```

### POST /campaigns/{id}/test

Envoyer un test à un contact (brouillon uniquement)

`test_campaign`

Autorisation requise : `messages:send`. Envoie un seul message de test de la campagne à un contact (envoi réel à cette personne ; exclu des statistiques ; ignore la liste de désinscription). Autorisé UNIQUEMENT tant que la campagne est en brouillon (state INIT) — sinon renvoie 409. Corps : {contactId}.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "messages:send",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/CampaignTestInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

##### HTTP 409

```json
{
  "description": "CAMPAIGN_NOT_DRAFT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CAMPAIGN_NOT_DRAFT"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "messages:send",
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": true,
    "idempotent": false,
    "warn": true
  }
}
```

### POST /uploads

Téléverser un fichier média (tout type)

`create_upload`

Autorisation requise : `uploads:write` (une clé `messages:write` est AUSSI acceptée pour le parcours de campagne). Téléverse une image/PDF/vidéo (multipart/form-data) et renvoie le nom de fichier hébergé + l’URL, à ASSOCIER ensuite à sa ressource (document de contact, média de campagne…). REMARQUE : multipart uniquement — un agent MCP/IA incapable d’envoyer un flux binaire doit transmettre une URL http(s) dans `url` à l’opération qui consomme le fichier (par ex. POST /contacts/{id}/documents), qui le réhéberge côté serveur.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "uploads:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "multipart/form-data": {
      "schema": {
        "type": "object",
        "properties": {
          "file": {
            "type": "string",
            "format": "binary"
          }
        }
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/UploadResult"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "UNSUPPORTED_MEDIA_TYPE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "UNSUPPORTED_MEDIA_TYPE"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "uploads:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### POST /uploads/image

Téléverser une image

`create_upload_image`

Autorisation requise : `uploads:write`. Téléverse uniquement une image (image/*, ≤ 5 Mo, multipart/form-data) et renvoie son nom de fichier hébergé + son URL. Suit le fonctionnement du téléversement d’images admin. Multipart uniquement (voir la remarque de POST /uploads pour MCP/IA).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "uploads:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "multipart/form-data": {
      "schema": {
        "type": "object",
        "properties": {
          "file": {
            "type": "string",
            "format": "binary"
          }
        }
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/UploadResult"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "WRONG_MEDIA_FAMILY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "WRONG_MEDIA_FAMILY"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "uploads:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### POST /uploads/pdf

Téléverser un PDF

`create_upload_pdf`

Autorisation requise : `uploads:write`. Téléverse uniquement un PDF (application/pdf, ≤ 15 Mo, multipart/form-data) et renvoie son nom de fichier hébergé + son URL. Suit le fonctionnement du téléversement de documents admin. Multipart uniquement (voir la remarque de POST /uploads pour MCP/IA).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "uploads:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "multipart/form-data": {
      "schema": {
        "type": "object",
        "properties": {
          "file": {
            "type": "string",
            "format": "binary"
          }
        }
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/UploadResult"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "WRONG_MEDIA_FAMILY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "WRONG_MEDIA_FAMILY"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "uploads:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /whatsapp-accounts

Lister les numéros WhatsApp connectés

`list_whatsapp_accounts`

Autorisation requise : `messages:read`. Liste les numéros WhatsApp connectés de l’organisation. Choisissez l’identifiant d’un numéro `ready` pour le définir comme whatsappAccountId de campagne.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": []
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WhatsappAccount"
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /whatsapp-accounts/{id}/status

Consulter l’état d’un numéro WhatsApp

`get_whatsapp_account_status`

Autorisation requise : `messages:read`. État actuel d’un numéro (`ready` = connecté et utilisable).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/WhatsappAccountStatus"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /messaging-configs

Lister les configurations d’envoi email et SMS

`list_messaging_configs`

Autorisation requise : `messages:read`. Configurations d’envoi email et SMS de l’organisation (sans secrets). Utilisez l’identifiant d’une configuration email comme `emailConfig` de campagne.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "messages:read",
  "additional": []
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/MessagingConfigs"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "messages:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /menu

Lister les éléments de menu (arborescence d’un site)

`list_menu`

Autorisation requise : `web_menu:read`. Renvoie les éléments du site (à plat, triés par position ; reconstruisez l’arborescence avec parent/position). Transmettez `?virtualId` pour cibler un site (omettre = site principal).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "web_menu:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Identifiant du site ; omettre pour le site principal."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MenuItem"
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "web_menu:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /menu

Créer un élément de menu

`create_menu_item`

Autorisation requise : `web_menu:write`. Crée un élément à la fin du niveau racine. Utilisez `targetId` pour les éléments PAGE/FORM/CAGNOTTE.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "web_menu:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/MenuItemInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/MenuItem"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "web_menu:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### POST /menu/reorder

Réorganiser/déplacer les éléments du menu

`reorder_menu`

Autorisation requise : `web_menu:write`. Définit le parent et la position des éléments en une seule opération (arborescence/glisser-déposer). Envoyez la disposition complète souhaitée.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "web_menu:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/MenuReorderInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "web_menu:write",
  "x-unisoft-mcp": {
    "category": "reorder",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /menu/{id}

Modifier un élément de menu

`update_menu_item`

Autorisation requise : `web_menu:write`. Modifie uniquement le contenu (pas le parent/la position). Transmettez le `virtualId` de l’élément dans le corps.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "web_menu:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/MenuItemInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/MenuItem"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "web_menu:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### DELETE /menu/{id}

Supprimer un élément de menu

`delete_menu_item`

Autorisation requise : `web_menu:write`. Transmettez `?virtualId` pour limiter l’opération au site.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "web_menu:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "web_menu:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /travel

Lister les sites Travel

`list_travel`

Autorisation requise : `travel:read`. Liste les sites touristiques de l’organisation pour découvrir leur `travelId`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:read",
  "additional": []
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TravelSite"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "ERREUR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INSUFFICIENT_SCOPE"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /travel/{travelId}

Obtenir un site Travel (configuration et lieux)

`get_travel`

Autorisation requise : `travel:read`. Renvoie la configuration assainie et toutes les collections de lieux enrichies, ainsi qu’un ensemble `shabbat` (groupe Shabbat du site et sessions à venir, comme GET /travel/{travelId}/shabbat). Les instructions système du chatbot et les clés API des fournisseurs ne sont jamais incluses.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelConfig"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /travel/{travelId}/config

Obtenir la configuration du site

`list_travel_config`

Autorisation requise : `travel:read`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelConfig"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /travel/{travelId}/shabbat

Obtenir les sessions Shabbat du site

`get_travel_shabbat`

Autorisation requise : `travel:read`. Renvoie le groupe Shabbat du site (métadonnées publiques et identifiant du bloc d’introduction IA) et ses sessions à venir/actives (même structure que les événements autonomes). Renvoie `{group:null, sessions:[]}` si aucun Shabbat n’est configuré. Les zmanim (heures d’entrée/sortie) ne sont pas inclus dans cette version.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/ShabbatBundle"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/config/theme

Modifier la section de configuration : thème

`update_travel_config_theme`

Autorisation requise : `travel:write`. Remplace uniquement cette section (les sections voisines ne changent pas). Utilise la structure i18n native (langue par défaut de l’organisation à la racine, autres langues sous forme de surcharges).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/TravelConfigTheme"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelConfigTheme"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/config/jewish-info

Modifier les informations pratiques juives (jewishInfo)

`update_travel_config_jewish_info`

Autorisation requise : `travel:write`. Remplace uniquement cette section (les sections voisines ne changent pas). Utilise la structure i18n native (langue par défaut de l’organisation à la racine, autres langues sous forme de surcharges).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/TravelConfigJewishInfo"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelConfigJewishInfo"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/config/horaires

Modifier la section de configuration : horaires

`update_travel_config_horaire`

Autorisation requise : `travel:write`. Remplace uniquement cette section (les sections voisines ne changent pas). Utilise la structure i18n native (langue par défaut de l’organisation à la racine, autres langues sous forme de surcharges).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/TravelConfigHoraires"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelConfigHoraires"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/config/menu

Modifier la section de configuration : menu

`update_travel_config_menu`

Autorisation requise : `travel:write`. Remplace uniquement cette section (les sections voisines ne changent pas). Utilise la structure i18n native (langue par défaut de l’organisation à la racine, autres langues sous forme de surcharges).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/TravelConfigMenu"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelConfigMenu"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/config/hero

Modifier la bannière principale (heroBanner)

`update_travel_config_hero`

Autorisation requise : `travel:write`. Remplace uniquement cette section (les sections voisines ne changent pas). Utilise la structure i18n native (langue par défaut de l’organisation à la racine, autres langues sous forme de surcharges).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/TravelConfigHeroBanner"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelConfigHeroBanner"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/config/homepage

Modifier la page d’accueil (homepage)

`update_travel_config_homepage`

Autorisation requise : `travel:write`. Remplace uniquement cette section (les sections voisines ne changent pas). Utilise la structure i18n native (langue par défaut de l’organisation à la racine, autres langues sous forme de surcharges).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/TravelConfigHomepage"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelConfigHomepage"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/config/beth-habad

Modifier la section Beth Habad (bethHabad)

`update_travel_config_beth_habad`

Autorisation requise : `travel:write`. Remplace uniquement cette section (les sections voisines ne changent pas). Utilise la structure i18n native (langue par défaut de l’organisation à la racine, autres langues sous forme de surcharges).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/TravelConfigBethHabad"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelConfigBethHabad"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/config/services

Modifier la section de configuration : services

`update_travel_config_service`

Autorisation requise : `travel:write`. Remplace uniquement cette section (les sections voisines ne changent pas). Utilise la structure i18n native (langue par défaut de l’organisation à la racine, autres langues sous forme de surcharges).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/TravelConfigServices"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelConfigServices"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/config/faq

Modifier les questions fréquentes (faq)

`update_travel_config_faq`

Autorisation requise : `travel:write`. Remplace uniquement cette section (les sections voisines ne changent pas). Utilise la structure i18n native (langue par défaut de l’organisation à la racine, autres langues sous forme de surcharges).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/TravelConfigFaq"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelConfigFaq"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/config/journey

Modifier les paramètres des annonces de voyage (journey)

`update_travel_config_journey`

Autorisation requise : `travel:write`. Remplace uniquement cette section (les sections voisines ne changent pas). Utilise la structure i18n native (langue par défaut de l’organisation à la racine, autres langues sous forme de surcharges).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/TravelConfigJourney"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelConfigJourney"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/config/chatbot

Modifier le chatbot du site (chatbot)

`update_travel_config_chatbot`

Autorisation requise : `travel:write`. Remplace uniquement cette section (les sections voisines ne changent pas). Utilise la structure i18n native (langue par défaut de l’organisation à la racine, autres langues sous forme de surcharges).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/TravelConfigChatbot"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelConfigChatbot"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/config/booking-api

Modifier l’API de réservation (bookingApi)

`update_travel_config_booking_api`

Autorisation requise : `travel:write`. Remplace uniquement cette section (les sections voisines ne changent pas). Utilise la structure i18n native (langue par défaut de l’organisation à la racine, autres langues sous forme de surcharges).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/TravelConfigBookingApi"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelConfigBookingApi"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/config/airbnb-api

Modifier l’intégration Airbnb (airbnbApi)

`update_travel_config_airbnb_api`

Autorisation requise : `travel:write`. Remplace uniquement cette section (les sections voisines ne changent pas). Utilise la structure i18n native (langue par défaut de l’organisation à la racine, autres langues sous forme de surcharges).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/TravelConfigAirbnbApi"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelConfigAirbnbApi"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/config/beth-habad-label

Modifier le libellé « Beth Habad » (i18n)

`update_travel_config_beth_habad_label`

Autorisation requise : `travel:write`. Corps : `{value, <lang>?…}` (chaînes simples). `value` est le libellé dans la langue par DÉFAUT de l’organisation (`org.language`). Chaque autre clé est une traduction indexée par code de langue — les clés valides sont les langues activées de l’organisation, SAUF la langue par défaut (l’envoi de la langue par défaut comme clé est refusé). Les propriétés ci-dessous (en/he/de/gr) sont les cas courants ; fr/it/ru/pt sont également acceptés si activés par l’organisation. Définissez une traduction à **null** pour la SUPPRIMER (l’omission de la clé la laisse intacte).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "value": {
            "type": "string",
            "description": "Libellé dans la langue par défaut de l’organisation (org.language)"
          },
          "en": {
            "type": "string",
            "nullable": true,
            "description": "Traduction anglaise (si \"en\" est une langue activée autre que la langue par défaut). null la supprime."
          },
          "he": {
            "type": "string",
            "nullable": true,
            "description": "Traduction hébraïque (si activée et différente de la langue par défaut). null la supprime."
          },
          "de": {
            "type": "string",
            "nullable": true,
            "description": "Traduction allemande (si activée et différente de la langue par défaut). null la supprime."
          },
          "gr": {
            "type": "string",
            "nullable": true,
            "description": "Traduction grecque (si activée et différente de la langue par défaut). null la supprime."
          }
        }
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/config/categories/{type}

Modifier la liste de catégories (kosher | hotel | attraction)

`update_travel_config_category`

Autorisation requise : `travel:write`. Corps : `{categories:[{id?, label, en?:{label}}]}`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "type",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "enum": [
      "kosher",
      "hotel",
      "attraction"
    ]
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "categories": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/I18nOverlay"
            }
          }
        }
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "UNKNOWN_CATEGORY_TYPE / TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "UNKNOWN_CATEGORY_TYPE / TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /travel/{travelId}/kosher

Lister les lieux casher

`list_travel_kosher`

Autorisation requise : `travel:read`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/KosherPlace"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /travel/{travelId}/kosher

Créer un lieu casher

`create_travel_kosher`

Autorisation requise : `travel:write`. `id` est généré ; `organisation`/`travel` sont imposés côté serveur. Les champs image acceptent une URL http(s) (réhébergée) ou un nom de fichier.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KosherPlace"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/KosherPlace"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /travel/{travelId}/kosher/{id}

Obtenir un lieu casher

`get_travel_kosher`

Autorisation requise : `travel:read`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/KosherPlace"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/kosher/{id}

Modifier un lieu casher

`update_travel_kosher`

Autorisation requise : `travel:write`. Fusionne les champs assainis avec le document existant.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/KosherPlace"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/KosherPlace"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### DELETE /travel/{travelId}/kosher/{id}

Supprimer un lieu casher

`delete_travel_kosher`

Autorisation requise : `travel:write`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /travel/{travelId}/kosher/positions

Réorganiser les lieux casher

`reorder_travel_kosher`

Autorisation requise : `travel:write`. Corps : `{positions:[{id, position}]}`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "positions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "position": {
                  "type": "integer"
                }
              }
            }
          }
        }
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "reorder",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /travel/{travelId}/hotels

Lister les hôtels

`list_travel_hotels`

Autorisation requise : `travel:read`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/HotelPlace"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /travel/{travelId}/hotels

Créer un hôtel

`create_travel_hotels`

Autorisation requise : `travel:write`. `id` est généré ; `organisation`/`travel` sont imposés côté serveur. Les champs image acceptent une URL http(s) (réhébergée) ou un nom de fichier.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/HotelPlace"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/HotelPlace"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /travel/{travelId}/hotels/{id}

Obtenir un hôtel

`get_travel_hotel`

Autorisation requise : `travel:read`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/HotelPlace"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/hotels/{id}

Modifier un hôtel

`update_travel_hotel`

Autorisation requise : `travel:write`. Fusionne les champs assainis avec le document existant.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/HotelPlace"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/HotelPlace"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### DELETE /travel/{travelId}/hotels/{id}

Supprimer un hôtel

`delete_travel_hotel`

Autorisation requise : `travel:write`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /travel/{travelId}/hotels/positions

Réorganiser les hôtels

`reorder_travel_hotels`

Autorisation requise : `travel:write`. Corps : `{positions:[{id, position}]}`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "positions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "position": {
                  "type": "integer"
                }
              }
            }
          }
        }
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "reorder",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /travel/{travelId}/attractions

Lister les attractions

`list_travel_attractions`

Autorisation requise : `travel:read`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AttractionPlace"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /travel/{travelId}/attractions

Créer une attraction

`create_travel_attractions`

Autorisation requise : `travel:write`. `id` est généré ; `organisation`/`travel` sont imposés côté serveur. Les champs image acceptent une URL http(s) (réhébergée) ou un nom de fichier.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AttractionPlace"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/AttractionPlace"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /travel/{travelId}/attractions/{id}

Obtenir une attraction

`get_travel_attraction`

Autorisation requise : `travel:read`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/AttractionPlace"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/attractions/{id}

Modifier une attraction

`update_travel_attraction`

Autorisation requise : `travel:write`. Fusionne les champs assainis avec le document existant.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AttractionPlace"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/AttractionPlace"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### DELETE /travel/{travelId}/attractions/{id}

Supprimer une attraction

`delete_travel_attraction`

Autorisation requise : `travel:write`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /travel/{travelId}/attractions/positions

Réorganiser les attractions

`reorder_travel_attractions`

Autorisation requise : `travel:write`. Corps : `{positions:[{id, position}]}`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "positions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "position": {
                  "type": "integer"
                }
              }
            }
          }
        }
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "reorder",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /travel/{travelId}/bookings

Lister les réservations importées

`list_travel_bookings`

Autorisation requise : `travel:read`. Lecture seule (importées via le back-office).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BookingPlace"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /travel/{travelId}/airbnbs

Lister les annonces Airbnb importées

`list_travel_airbnbs`

Autorisation requise : `travel:read`. Lecture seule (importées via le back-office).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AirbnbPlace"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /travel/{travelId}/journeys

Lister les demandes d’annonce de voyage

`list_travel_journeys`

Autorisation requise : `travel:read`. Demandes entrantes de touristes associées à un contact CRM.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

```json
{
  "name": "seasonId",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "includeCancelled",
  "in": "query",
  "schema": {
    "type": "boolean"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Journey"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /travel/{travelId}/sections

Lister les rubriques personnalisées

`list_travel_sections`

Autorisation requise : `travel:read`. Chaque rubrique contient un `itemCount`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TravelSection"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /travel/{travelId}/sections

Créer une rubrique personnalisée

`create_travel_sections`

Autorisation requise : `travel:write`. `slug` est normalisé et rendu unique par site (dérivé de `label` s’il est omis). Les options `fields` déterminent les champs utilisés par la rubrique.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/TravelSection"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelSection"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /travel/{travelId}/sections/{sid}

Obtenir une rubrique personnalisée

`get_travel_section`

Autorisation requise : `travel:read`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "sid",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelSection"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "SECTION_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "SECTION_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/sections/{sid}

Modifier une rubrique personnalisée

`update_travel_section`

Autorisation requise : `travel:write`. Mise à jour partielle ; le slug est recalculé si `label`/`slug` change.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "sid",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/TravelSection"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelSection"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "SECTION_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "SECTION_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### DELETE /travel/{travelId}/sections/{sid}

Supprimer une rubrique personnalisée (et ses lieux)

`delete_travel_section`

Autorisation requise : `travel:write`. Tous les lieux de la rubrique sont également supprimés.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "sid",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "SECTION_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "SECTION_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /travel/{travelId}/sections/positions

Réorganiser les rubriques personnalisées

`reorder_travel_sections`

Autorisation requise : `travel:write`. Corps : `{positions:[{id, position}]}`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "positions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "position": {
                  "type": "integer"
                }
              }
            }
          }
        }
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "TRAVEL_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "TRAVEL_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "reorder",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /travel/{travelId}/sections/{sid}/items

Lister les lieux d’une rubrique personnalisée

`list_travel_sections_items`

Autorisation requise : `travel:read`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "sid",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TravelSectionItem"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "SECTION_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "SECTION_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /travel/{travelId}/sections/{sid}/items

Créer un lieu dans une rubrique personnalisée

`create_travel_sections_items`

Autorisation requise : `travel:write`. `sectionId` est imposé à partir du chemin. Les champs de lieu non activés par les options `fields` de la rubrique sont tout de même acceptés (le tiers affiche sa propre interface).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "sid",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/TravelSectionItem"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelSectionItem"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "SECTION_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "SECTION_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /travel/{travelId}/sections/{sid}/items/{id}

Obtenir un lieu d’une rubrique personnalisée

`get_travel_sections_item`

Autorisation requise : `travel:read`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "sid",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelSectionItem"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /travel/{travelId}/sections/{sid}/items/{id}

Modifier un lieu d’une rubrique personnalisée

`update_travel_sections_item`

Autorisation requise : `travel:write`. Mise à jour partielle.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "sid",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/TravelSectionItem"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/TravelSectionItem"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### DELETE /travel/{travelId}/sections/{sid}/items/{id}

Supprimer un lieu d’une rubrique personnalisée

`delete_travel_sections_item`

Autorisation requise : `travel:write`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "sid",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /travel/{travelId}/sections/{sid}/items/positions

Réorganiser les lieux d’une rubrique personnalisée

`reorder_travel_sections_items`

Autorisation requise : `travel:write`. Corps : `{positions:[{id, position}]}`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "travel:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "travelId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "sid",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "positions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "position": {
                  "type": "integer"
                }
              }
            }
          }
        }
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "SECTION_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "SECTION_NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "travel:write",
  "x-unisoft-mcp": {
    "category": "reorder",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /site/facades

Lister les façades (sites) de l’organisation

`list_site_facades`

Autorisation requise : `site:read`. Liste le site principal et les sites virtuels afin de savoir quel `virtualId` transmettre aux autres opérations /site.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "site:read",
  "additional": []
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SiteFacade"
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "Clé absente ou invalide"
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE"
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "site:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /site

Obtenir la configuration du thème du site classique

`get_site`

Autorisation requise : `site:read`. Renvoie la configuration normalisée du thème (apparence, menu, bannière principale, bannières, homeSections, preFooterSections, donationPage) de la façade indiquée par `?virtualId` (omettre = site principal).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "site:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/SiteConfig"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND"
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "site:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /site/appearance

Définir le thème et les tokens de couleur/police

`update_site_appearance`

Autorisation requise : `site:write`. Définit le `theme` actif et/ou les `tokens` 2026 ; chaque champ fourni remplace sa valeur correspondante. Cible la façade indiquée par `?virtualId` (omettre = site principal).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "site:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SiteAppearance"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "site:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /site/seo

Obtenir le SEO par défaut du site

`get_site_seo`

Autorisation requise : `site:read`. SEO par défaut de la page d’accueil et de toute page CMS publique sans SEO propre. Chaque champ est résolu indépendamment : SEO explicite de la page, puis valeur par défaut du site, puis valeur générée automatiquement existante. S’applique aux thèmes classique, Travel, mobile et campagne. Les valeurs de la langue par défaut sont à la racine ; les autres langues activées utilisent des surcharges partielles. Les champs/surcharges omis sont conservés ; null ou une chaîne vide efface une valeur individuelle (rétablit la valeur de repli). Un objet de langue null/vide supprime uniquement cette surcharge.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "site:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/SiteSeo"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND"
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "site:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /site/seo

Modifier le SEO par défaut du site

`update_site_seo`

Autorisation requise : `site:write`. SEO par défaut de la page d’accueil et de toute page CMS publique sans SEO propre. Chaque champ est résolu indépendamment : SEO explicite de la page, puis valeur par défaut du site, puis valeur générée automatiquement existante. S’applique aux thèmes classique, Travel, mobile et campagne. Les valeurs de la langue par défaut sont à la racine ; les autres langues activées utilisent des surcharges partielles. Les champs/surcharges omis sont conservés ; null ou une chaîne vide efface une valeur individuelle (rétablit la valeur de repli). Un objet de langue null/vide supprime uniquement cette surcharge. Cible la façade indiquée par `?virtualId` (omettre = site principal).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "site:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SiteSeo"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/SiteSeo"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION"
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND ou NOT_FOUND"
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "site:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /site/donation-page

Obtenir tous les paramètres de la page de don principale

`get_site_donation_page`

Autorisation requise : `site:read`. Renvoie tous les paramètres de la page de don principale, y compris le contenu/médias/listes de montants prédéfinis des autres langues, la cagnotte principale associée et la redirection principale /don. Fonctionne avec les thèmes classique, Travel et mobile. Également accessible sous donationPage dans GET /site. Cible la façade indiquée par `?virtualId` (omettre = site principal).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "site:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/SiteDonationPage"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND"
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "site:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /site/donation-page

Modifier tous les paramètres de la page de don principale

`update_site_donation_page`

Autorisation requise : `site:write`. Paramètres de la page de don principale (admin « Ma page de don »), partagés par les thèmes classique, Travel et mobile. Mise à jour partielle : les champs et traductions omis sont conservés. Les tableaux de médias/montants prédéfinis remplacent le tableau fourni. Les valeurs de la langue par défaut sont à la racine ; les autres langues peuvent remplacer les cinq champs de présentation, y compris les tableaux entiers. Une cagnotte `mainCaisse` associée fournit son propre contenu/média/montants prédéfinis ; la redirection prévaut sur la page /don principale. Ne modifie pas les paramètres généraux des fournisseurs de paiement de l’organisation ni la configuration de campagne. Les champs omis dans une surcharge linguistique sont également conservés. Envoyez une langue à null ou {} pour supprimer uniquement les traductions de cette page dans cette langue, sans toucher aux autres traductions du site. Null sur un texte/une image traduits supprime cette personnalisation ; [] vide un tableau traduit. Les images de la langue principale et des autres langues sont réhébergées ; un échec d’importation annule la mise à jour. Les champs inconnus, les surcharges pour une langue désactivée et les champs de routage non traduisibles dans une surcharge sont refusés. `mainCaisse` doit appartenir à cette organisation. Utilisez GET /me pour connaître defaultLanguage/enabledLanguages. Gérez séparément les fournisseurs de paiement globaux. Cible la façade indiquée par `?virtualId` (omettre = site principal).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "site:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SiteDonationPage"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/SiteDonationPage"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND, CAISSE_NOT_FOUND ou NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "site:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /site/menu

Définir les boutons CTA de l’en-tête

`update_site_menu`

Autorisation requise : `site:write`. Remplace les deux boutons d’appel à l’action de l’en-tête (envoyez l’objet complet). Cible la façade indiquée par `?virtualId` (omettre = site principal).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "site:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SiteMenu"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "site:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /site/hero

Définir les diapositives du carrousel de la bannière principale

`update_site_hero`

Autorisation requise : `site:write`. Remplace l’intégralité du carrousel de la bannière principale par le tableau `slides` fourni. Cible la façade indiquée par `?virtualId` (omettre = site principal).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "site:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "slides"
        ],
        "properties": {
          "slides": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SiteSlide"
            },
            "description": "Diapositives de la bannière principale, dans l’ordre (remplace tout le carrousel)."
          }
        }
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "site:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /site/banners

Définir les bannières promotionnelles

`update_site_banners`

Autorisation requise : `site:write`. Remplace les bannières promotionnelles par le tableau `items` fourni. Cible la façade indiquée par `?virtualId` (omettre = site principal).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "site:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "items"
        ],
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SiteSlide"
            },
            "description": "Bannières promotionnelles (remplace tout le contenu existant)."
          }
        }
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "site:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /site/home-sections

Définir les sections de la page d’accueil

`update_site_home_sections`

Autorisation requise : `site:write`. Remplace la composition de la page d’accueil par le tableau `sections` fourni (l’ordre du tableau détermine l’ordre sur la page). Appelez GET /site d’abord pour conserver les sections intégrées et leurs identifiants. Une section CUSTOM_CONTENT avec props.contentType="AI" référence un aiContentBlockId — écrivez son HTML via PUT /content-blocks/{id}/content. Cible la façade indiquée par `?virtualId` (omettre = site principal).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "site:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "sections"
        ],
        "properties": {
          "sections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SiteSection"
            },
            "description": "Sections d’accueil dans l’ordre (remplace la composition actuelle)."
          }
        }
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "site:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /site/prefooter-sections

Définir les sections avant le pied de page

`update_site_prefooter_sections`

Autorisation requise : `site:write`. Remplace les sections affichées avant le pied de page sur chaque page. Cible la façade indiquée par `?virtualId` (omettre = site principal).

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "site:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "sections"
        ],
        "properties": {
          "sections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SiteSection"
            },
            "description": "Sections avant le pied de page, dans l’ordre (remplace toutes les sections existantes)."
          }
        }
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "site:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /mobile-config/facades

Lister les façades (applications mobiles) de l’organisation

`list_mobile_config_facades`

Autorisation requise : `mobile_config:read`. Liste l’application principale et les applications virtuelles afin de savoir quel `virtualId` transmettre aux autres opérations /mobile-config.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "mobile_config:read",
  "additional": []
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MobileFacade"
            }
          }
        }
      }
    }
  }
}
```

##### HTTP 401

```json
{
  "description": "Clé absente ou invalide"
}
```

##### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE"
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "mobile_config:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /mobile-config

Obtenir la configuration de l’application mobile

`get_mobile_config`

Autorisation requise : `mobile_config:read`. Renvoie la configuration mobile normalisée (label, active, config.*, ainsi que distribution et knownHosts en lecture seule) de la façade indiquée par `?virtualId` (omettre = application principale). Renvoie 404 si l’application n’est pas provisionnée.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "mobile_config:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/MobileConfig"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND ou MOBILE_CONFIG_NOT_PROVISIONED"
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "mobile_config:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /mobile-config/meta

Définir le libellé/l’état actif de la configuration

`update_mobile_config_meta`

Autorisation requise : `mobile_config:write`. Définit les métadonnées de cycle de vie à la racine (`label` et/ou `active`). Cible la façade indiquée par `?virtualId` (omettre = application principale). Renvoie 404 si l’application n’est pas provisionnée.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "mobile_config:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/MobileMeta"
      },
      "example": {
        "label": "App Beth Habad",
        "active": true
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND ou MOBILE_CONFIG_NOT_PROVISIONED",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "mobile_config:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /mobile-config/branding

Définir les couleurs d’accent de l’application

`update_mobile_config_branding`

Autorisation requise : `mobile_config:write`. Définit les couleurs d’accent dans l’application (principale/secondaire). Cible la façade indiquée par `?virtualId` (omettre = application principale). Renvoie 404 si l’application n’est pas provisionnée.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "mobile_config:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/MobileBranding"
      },
      "example": {
        "primary": "#1D4ED8",
        "secondary": "#F59E0B"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND ou MOBILE_CONFIG_NOT_PROVISIONED",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "mobile_config:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /mobile-config/bottom-bar

Définir l’apparence de la barre inférieure

`update_mobile_config_bottom_bar`

Autorisation requise : `mobile_config:write`. Définit l’apparence de la barre d’onglets inférieure (visible / variant / showLabels). Cible la façade indiquée par `?virtualId` (omettre = application principale). Renvoie 404 si l’application n’est pas provisionnée.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "mobile_config:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/MobileBottomBar"
      },
      "example": {
        "visible": true,
        "variant": "fixed",
        "showLabels": true
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND ou MOBILE_CONFIG_NOT_PROVISIONED",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "mobile_config:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /mobile-config/tabs

Définir les onglets de la barre inférieure

`update_mobile_config_tabs`

Autorisation requise : `mobile_config:write`. Remplace toute la liste d’onglets inférieure par le tableau `tabs` fourni (son ordre détermine l’affichage à l’écran). Cible la façade indiquée par `?virtualId` (omettre = application principale). Renvoie 404 si l’application n’est pas provisionnée.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "mobile_config:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "tabs"
        ],
        "properties": {
          "tabs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MobileTab"
            },
            "description": "Onglets de la barre inférieure, dans l’ordre (remplace tous les onglets)."
          }
        }
      },
      "example": {
        "tabs": [
          {
            "url": "",
            "label": "Accueil",
            "icon": {
              "name": "home",
              "source": "lucide"
            },
            "active": true
          },
          {
            "url": "/don",
            "label": "Don",
            "en": {
              "label": "Donate"
            },
            "icon": {
              "name": "heart",
              "source": "lucide"
            },
            "active": true
          }
        ]
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND ou MOBILE_CONFIG_NOT_PROVISIONED",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "mobile_config:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /mobile-config/header

Définir l’en-tête de l’application

`update_mobile_config_header`

Autorisation requise : `mobile_config:write`. Définit la barre supérieure de l’application (visible / sticky / showBack / title / actions). Envoyez l’objet complet. Cible la façade indiquée par `?virtualId` (omettre = application principale). Renvoie 404 si l’application n’est pas provisionnée.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "mobile_config:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/MobileHeader"
      },
      "example": {
        "visible": true,
        "sticky": true,
        "showBack": true,
        "title": {
          "mode": "SHORTNAME"
        },
        "actions": [
          {
            "type": "DRAWER",
            "icon": {
              "name": "menu",
              "source": "lucide"
            },
            "label": "Menu"
          }
        ]
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND ou MOBILE_CONFIG_NOT_PROVISIONED",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "mobile_config:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /mobile-config/onboarding

Définir les écrans de bienvenue

`update_mobile_config_onboarding`

Autorisation requise : `mobile_config:write`. Définit le carrousel d’intégration du premier lancement (enabled / version / slides). Cible la façade indiquée par `?virtualId` (omettre = application principale). Renvoie 404 si l’application n’est pas provisionnée.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "mobile_config:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/MobileOnboarding"
      },
      "example": {
        "enabled": true,
        "version": 1,
        "slides": [
          {
            "title": "Bienvenue",
            "en": {
              "title": "Welcome"
            },
            "description": "Découvrez notre app",
            "textPosition": "bottom",
            "overlay": "LIGHT"
          }
        ]
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND ou MOBILE_CONFIG_NOT_PROVISIONED",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "mobile_config:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /mobile-config/account

Définir l’exigence de connexion au compte

`update_mobile_config_account`

Autorisation requise : `mobile_config:write`. Définit si l’application demande à l’utilisateur de se connecter (mode NONE/OPTIONAL/REQUIRED + version). Pris en compte uniquement si l’espace de compte est disponible pour l’organisation. Cible la façade indiquée par `?virtualId` (omettre = application principale). Renvoie 404 si l’application n’est pas provisionnée.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "mobile_config:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/MobileAccount"
      },
      "example": {
        "mode": "OPTIONAL",
        "version": 1
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND ou MOBILE_CONFIG_NOT_PROVISIONED",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "mobile_config:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /mobile-config/initial-url

Définir l’URL de démarrage de l’application

`update_mobile_config_initial_url`

Autorisation requise : `mobile_config:write`. Définit l’URL exacte ouverte par l’application au démarrage (`initialUrl`) ; une valeur vide signifie qu’elle est déduite automatiquement du domaine de l’organisation. Cible la façade indiquée par `?virtualId` (omettre = application principale). Renvoie 404 si l’application n’est pas provisionnée.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "mobile_config:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/MobileInitialUrl"
      },
      "example": {
        "initialUrl": "/accueil-app"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND ou MOBILE_CONFIG_NOT_PROVISIONED",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "mobile_config:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /mobile-config/external-apps

Définir les règles de routage des liens externes

`update_mobile_config_external_apps`

Autorisation requise : `mobile_config:write`. Remplace la liste des liens qui s’ouvrent nativement plutôt que dans le navigateur intégré (transmise dans `items`). Cible la façade indiquée par `?virtualId` (omettre = application principale). Renvoie 404 si l’application n’est pas provisionnée.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "mobile_config:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "items"
        ],
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MobileExternalApp"
            },
            "description": "Règles de routage des liens externes (remplace toutes les règles existantes)."
          }
        }
      },
      "example": {
        "items": [
          {
            "match": "my-partner.com",
            "mode": "SYSTEM"
          }
        ]
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND ou MOBILE_CONFIG_NOT_PROVISIONED",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "mobile_config:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /mobile-config/sections

Définir les sections de l’accueil

`update_mobile_config_sections`

Autorisation requise : `mobile_config:write`. Remplace la composition de l’accueil mobile par le tableau `sections` fourni (son ordre détermine l’ordre à l’écran). Appelez GET /mobile-config d’abord pour conserver les sections et identifiants existants. Une section CUSTOM_CONTENT avec props.contentType="AI" référence un aiContentBlockId — écrivez son HTML via PUT /content-blocks/{id}/content. Cible la façade indiquée par `?virtualId` (omettre = application principale). Renvoie 404 si l’application n’est pas provisionnée.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "mobile_config:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "sections"
        ],
        "properties": {
          "sections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MobileSection"
            },
            "description": "Sections d’accueil dans l’ordre (remplace la composition actuelle)."
          }
        }
      },
      "example": {
        "sections": [
          {
            "type": "HERO",
            "label": "Hero",
            "props": {
              "slides": [
                {
                  "image": "https://example.com/hero.jpg",
                  "title": "Bienvenue",
                  "btn1_label": "Faire un don",
                  "btn1_url": "/don"
                }
              ]
            }
          },
          {
            "type": "ACTIONS_GRID",
            "label": "Raccourcis",
            "props": {
              "style": "ROUND",
              "items": [
                {
                  "icon": {
                    "name": "heart",
                    "source": "lucide"
                  },
                  "label": "Don",
                  "url": "/don"
                }
              ]
            }
          },
          {
            "type": "EVENTS_PREVIEW",
            "label": "Événements",
            "props": {
              "title": "Nos événements",
              "limit": 5
            }
          }
        ]
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND ou MOBILE_CONFIG_NOT_PROVISIONED",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "mobile_config:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /mobile-config/prefooter-sections

Définir les sections avant le pied de page

`update_mobile_config_prefooter_sections`

Autorisation requise : `mobile_config:write`. Remplace les sections affichées avant le pied de page sur chaque écran (transmises dans `sections`). Cible la façade indiquée par `?virtualId` (omettre = application principale). Renvoie 404 si l’application n’est pas provisionnée.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "mobile_config:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "sections"
        ],
        "properties": {
          "sections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MobileSection"
            },
            "description": "Sections avant le pied de page, dans l’ordre (remplace toutes les sections existantes)."
          }
        }
      },
      "example": {
        "sections": [
          {
            "type": "NEWSLETTER",
            "label": "Newsletter",
            "props": {
              "title": "Restez informés"
            }
          }
        ]
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "FACADE_NOT_FOUND ou MOBILE_CONFIG_NOT_PROVISIONED",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/Error"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "mobile_config:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /annual-events

Lister les événements annuels gérés

`list_annual_events`

Autorisation requise : `events:read`. Liste les projets d’événement créés via le parcours guidé de façade pour événements annuels. Inclut les événements ordinaires ponctuels et récurrents ; exclut par conception tous les parcours Shabbat/fêtes préfabriquées.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "events:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

```json
{
  "name": "year",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 2000,
    "maximum": 2200
  }
}
```

```json
{
  "name": "publicationStatus",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "CREATED",
      "PUBLISHED",
      "PUBLISHING",
      "PUBLISH_FAILED"
    ]
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AnnualEventProject"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "AUTORISATION_INSUFFISANTE"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "events:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /annual-events

Créer et publier un événement ordinaire

`create_annual_event`

Autorisation requise : `events:write`. Coordonne de façon idempotente la page, le groupe, les sessions et le brouillon de formulaire/cagnotte/campagne demandé à partir d’une recette vérifiée. `idempotencyKey` est obligatoire dans le corps JSON pour REST et MCP ; l’en-tête facultatif `Idempotency-Key` peut le remplacer pour les nouvelles tentatives de transport. Une campagne reste toujours en brouillon et n’est jamais envoyée par cette opération.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "events:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "Idempotency-Key",
  "in": "header",
  "schema": {
    "type": "string",
    "maxLength": 200
  }
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AnnualEventCreateInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AnnualEventPublishResult"
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "INVALID_INPUT"
      }
    }
  }
}
```

##### HTTP 409

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "CONFLICT"
      }
    }
  }
}
```

##### HTTP 422

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "ERREUR_DE_VALIDATION"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "events:write"
}
```

### GET /annual-events/groups

Lister les groupes d’événements ordinaires compatibles

`list_annual_event_groups`

Autorisation requise : `events:read`. Liste uniquement les groupes ordinaires à session unique pouvant accueillir un nouvel événement sans risque. Les groupes Shabbat, fêtes préfabriquées et sessions multiples sont exclus.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "events:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200,
    "default": 50
  },
  "description": "Nombre de résultats par page."
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Curseur opaque renvoyé par la requête précédente."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AnnualEventCompatibleGroup"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "AUTORISATION_INSUFFISANTE"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "events:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /annual-events/poster-analysis

Préparer un brouillon d’événement à partir d’une affiche

`analyze_annual_event_poster`

Autorisation requise : `events:write`. Analyse une véritable image d’affiche et renvoie une recette suggérée complète. Ne publie rien ; l’appelant doit présenter le résultat pour vérification, compléter les champs incertains, puis appeler `create_annual_event`.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "events:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AnnualEventPosterAnalysisRequest"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/AnnualEventPosterAnalysis"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "INVALID_POSTER"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "POSTER_NOT_FOUND"
      }
    }
  }
}
```

##### HTTP 503

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "AI_UNAVAILABLE"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "events:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /annual-events/{id}

Obtenir un événement annuel géré

`get_annual_event`

Autorisation requise : `events:read`. Renvoie le projet canonique, sa recette vérifiée, sa révision, son URL publique et les identifiants de ses sessions, formulaires, cagnottes et brouillons de campagne.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "events:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  },
  "description": "Identifiant du projet d’événement annuel."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/AnnualEventProject"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "EVENT_NOT_FOUND"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "events:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /annual-events/{id}

Modifier et republier un événement annuel géré

`update_annual_event`

Autorisation requise : `events:write`. Applique une mise à jour partielle à la recette enregistrée et republie les ressources gérées. Envoyez `expectedRevision` pour refuser une modification obsolète avec 409. Les tableaux fournis remplacent leur valeur précédente. Une campagne reste en brouillon et n’est jamais envoyée par cette opération.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "events:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  },
  "description": "Identifiant du projet d’événement annuel."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "patch": {
            "$ref": "#/components/schemas/AnnualEventPatch"
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "timeZone": {
            "type": "string"
          }
        },
        "required": [
          "expectedRevision",
          "patch"
        ]
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AnnualEventPublishResult"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "EVENT_NOT_FOUND"
      }
    }
  }
}
```

##### HTTP 409

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "REVISION_CONFLICT"
      }
    }
  }
}
```

##### HTTP 422

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        },
        "description": "ERREUR_DE_VALIDATION"
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "events:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /fundraising-campaigns

Lister les campagnes de dons

`listFundraisingCampaigns`

Autorisation requise : `fundraising:read`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "query",
  "name": "limit",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200
  }
}
```

```json
{
  "in": "query",
  "name": "cursor",
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "in": "query",
  "name": "search",
  "schema": {
    "type": "string",
    "maxLength": 200
  }
}
```

```json
{
  "in": "query",
  "name": "status",
  "schema": {
    "type": "string",
    "enum": [
      "DRAFT",
      "PUBLISHED",
      "PAUSED",
      "ARCHIVED"
    ]
  }
}
```

```json
{
  "in": "query",
  "name": "type",
  "schema": {
    "type": "string",
    "enum": [
      "AMOUNT",
      "COUNT",
      "PARTNER"
    ]
  }
}
```

```json
{
  "in": "query",
  "name": "dateStartFrom",
  "schema": {
    "type": "string",
    "format": "date-time"
  }
}
```

```json
{
  "in": "query",
  "name": "dateStartTo",
  "schema": {
    "type": "string",
    "format": "date-time"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FundraisingCampaignRead"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:read"
}
```

### POST /fundraising-campaigns

Créer une campagne de dons

`createFundraisingCampaign`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 120
          },
          "url": {
            "type": "string",
            "maxLength": 60,
            "pattern": "^campaign-[a-z0-9][a-z0-9-]{0,49}[a-z0-9]$"
          },
          "type": {
            "type": "string",
            "enum": [
              "AMOUNT",
              "COUNT",
              "PARTNER"
            ]
          },
          "objectif": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 1000000000,
            "multipleOf": 0.01
          },
          "matched": {
            "type": "number",
            "minimum": 1,
            "maximum": 100
          },
          "partnerMontant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "dateStart": {
            "type": "string",
            "maxLength": 40,
            "format": "date-time",
            "nullable": true
          },
          "dateEnd": {
            "type": "string",
            "maxLength": 40,
            "format": "date-time",
            "nullable": true
          },
          "donationPolicy": {
            "type": "string",
            "enum": [
              "OPEN",
              "SCHEDULED"
            ]
          },
          "bonus": {
            "type": "array",
            "items": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 10000000,
              "multipleOf": 0.01
            },
            "maxItems": 30
          },
          "gala": {
            "type": "boolean"
          },
          "ambs": {
            "type": "boolean"
          },
          "stockable": {
            "type": "boolean"
          },
          "tombola": {
            "type": "boolean",
            "deprecated": true,
            "description": "Alias historique de stockable. Conservé en lecture pour compatibilité ; utilisez stockable pour les nouvelles campagnes."
          },
          "presentCategories": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 60
            },
            "maxItems": 20
          },
          "ambsCategories": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 60
            },
            "maxItems": 20
          },
          "config": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "hidden": {
                      "type": "boolean"
                    },
                    "editable": {
                      "type": "boolean"
                    },
                    "contentType": {
                      "type": "string",
                      "enum": [
                        "EDITOR",
                        "AI"
                      ]
                    },
                    "aiContentBlockId": {
                      "type": "string",
                      "maxLength": 36,
                      "format": "uuid"
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "image": {
                      "type": "string",
                      "maxLength": 255,
                      "format": "asset"
                    },
                    "background": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "color": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "url": {
                      "type": "string",
                      "maxLength": 2000,
                      "format": "safe-url"
                    }
                  },
                  "required": [
                    "id",
                    "type"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "banners": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "maxLength": 36,
                      "format": "uuid"
                    },
                    "image": {
                      "type": "string",
                      "maxLength": 255,
                      "format": "asset"
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "DESKTOP",
                        "MOBILE"
                      ]
                    }
                  },
                  "required": [
                    "image",
                    "type"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 30
              },
              "metaImage": {
                "type": "string",
                "maxLength": 255,
                "format": "asset"
              },
              "banners.youtube": {
                "type": "string",
                "maxLength": 2000,
                "format": "safe-url"
              },
              "template": {
                "type": "string",
                "maxLength": 300
              },
              "designVariant": {
                "type": "string",
                "maxLength": 300,
                "description": "Mise en page de présentation V2. En cas de valeur absente, vide ou non prise en charge, le design standard actuel est utilisé. Indépendante des couleurs et du paiement ; conservée pour la compatibilité future."
              },
              "ambiance": {
                "type": "string",
                "maxLength": 300
              },
              "ald.logo": {
                "type": "string",
                "maxLength": 255,
                "format": "asset"
              },
              "ald.name": {
                "type": "string",
                "maxLength": 300
              },
              "ald.leftBanner": {
                "type": "string",
                "maxLength": 255,
                "format": "asset"
              },
              "ald.presetButtons": {
                "type": "string",
                "maxLength": 2000
              },
              "tokens": {
                "type": "object",
                "properties": {
                  "main": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string",
                      "maxLength": 500
                    },
                    "maxProperties": 100
                  },
                  "custom": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string",
                      "maxLength": 500
                    },
                    "maxProperties": 100
                  }
                },
                "required": [],
                "additionalProperties": false
              },
              "v2Checkout": {
                "type": "boolean"
              },
              "noModal": {
                "type": "boolean"
              },
              "noPromesse": {
                "type": "boolean"
              },
              "hideBar": {
                "type": "boolean"
              },
              "hideOrg": {
                "type": "boolean"
              },
              "autoDisplay": {
                "type": "boolean"
              },
              "forceCelebration": {
                "type": "boolean"
              },
              "fixedMontant": {
                "type": "boolean"
              },
              "noDefaultProduct": {
                "type": "boolean"
              },
              "giftAidBoost": {
                "type": "boolean"
              },
              "minMontant": {
                "type": "number",
                "minimum": 0.01,
                "maximum": 10000000,
                "multipleOf": 0.01
              },
              "productMonth": {
                "type": "boolean"
              },
              "maxNbMonth": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "minNbMonth": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "defaultNbMonth": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "forceMonthNb": {
                "type": "integer",
                "minimum": 0,
                "maximum": 120,
                "nullable": true
              },
              "maxDivideNB": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "monthlyAmountDisplay": {
                "type": "boolean"
              },
              "forceDivideGTEAmount": {
                "type": "number",
                "minimum": 0.01,
                "maximum": 10000000,
                "multipleOf": 0.01
              },
              "forceDivideNB": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "matched": {
                "type": "number",
                "minimum": 1,
                "maximum": 100
              },
              "currencies": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "devise": {
                      "type": "string",
                      "maxLength": 3,
                      "pattern": "^[a-z]{3}$"
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "REAL",
                        "VIRTUAL"
                      ]
                    },
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "assocId": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [
                    "devise",
                    "type"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 20
              },
              "categories": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 60
                },
                "maxItems": 20
              },
              "donorEmailTemplate": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              },
              "fr": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "en": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "he": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "de": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "it": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "es": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "pt": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "ru": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "gr": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "ro": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "fr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [
          "label",
          "url",
          "objectif"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingCampaignRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### GET /fundraising-campaigns/resolve/{url}

Retrouver une campagne de dons par son URL

`resolveFundraisingCampaign`

Autorisation requise : `fundraising:read`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "url",
  "required": true,
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingCampaignRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:read"
}
```

### GET /fundraising-campaigns/{id}

Obtenir une campagne de dons

`getFundraisingCampaign`

Autorisation requise : `fundraising:read`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingCampaignRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:read"
}
```

### PATCH /fundraising-campaigns/{id}

Modifier une campagne de dons

`updateFundraisingCampaign`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 120
          },
          "url": {
            "type": "string",
            "maxLength": 60,
            "pattern": "^campaign-[a-z0-9][a-z0-9-]{0,49}[a-z0-9]$"
          },
          "type": {
            "type": "string",
            "enum": [
              "AMOUNT",
              "COUNT",
              "PARTNER"
            ]
          },
          "objectif": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 1000000000,
            "multipleOf": 0.01
          },
          "matched": {
            "type": "number",
            "minimum": 1,
            "maximum": 100
          },
          "partnerMontant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "dateStart": {
            "type": "string",
            "maxLength": 40,
            "format": "date-time",
            "nullable": true
          },
          "dateEnd": {
            "type": "string",
            "maxLength": 40,
            "format": "date-time",
            "nullable": true
          },
          "donationPolicy": {
            "type": "string",
            "enum": [
              "OPEN",
              "SCHEDULED"
            ]
          },
          "bonus": {
            "type": "array",
            "items": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 10000000,
              "multipleOf": 0.01
            },
            "maxItems": 30
          },
          "gala": {
            "type": "boolean"
          },
          "ambs": {
            "type": "boolean"
          },
          "stockable": {
            "type": "boolean"
          },
          "tombola": {
            "type": "boolean",
            "deprecated": true,
            "description": "Alias historique de stockable. Conservé en lecture pour compatibilité ; utilisez stockable pour les nouvelles campagnes."
          },
          "presentCategories": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 60
            },
            "maxItems": 20
          },
          "ambsCategories": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 60
            },
            "maxItems": 20
          },
          "config": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "hidden": {
                      "type": "boolean"
                    },
                    "editable": {
                      "type": "boolean"
                    },
                    "contentType": {
                      "type": "string",
                      "enum": [
                        "EDITOR",
                        "AI"
                      ]
                    },
                    "aiContentBlockId": {
                      "type": "string",
                      "maxLength": 36,
                      "format": "uuid"
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "image": {
                      "type": "string",
                      "maxLength": 255,
                      "format": "asset"
                    },
                    "background": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "color": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "url": {
                      "type": "string",
                      "maxLength": 2000,
                      "format": "safe-url"
                    }
                  },
                  "required": [
                    "id",
                    "type"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "banners": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "maxLength": 36,
                      "format": "uuid"
                    },
                    "image": {
                      "type": "string",
                      "maxLength": 255,
                      "format": "asset"
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "DESKTOP",
                        "MOBILE"
                      ]
                    }
                  },
                  "required": [
                    "image",
                    "type"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 30
              },
              "metaImage": {
                "type": "string",
                "maxLength": 255,
                "format": "asset"
              },
              "banners.youtube": {
                "type": "string",
                "maxLength": 2000,
                "format": "safe-url"
              },
              "template": {
                "type": "string",
                "maxLength": 300
              },
              "designVariant": {
                "type": "string",
                "maxLength": 300,
                "description": "Mise en page de présentation V2. En cas de valeur absente, vide ou non prise en charge, le design standard actuel est utilisé. Indépendante des couleurs et du paiement ; conservée pour la compatibilité future."
              },
              "ambiance": {
                "type": "string",
                "maxLength": 300
              },
              "ald.logo": {
                "type": "string",
                "maxLength": 255,
                "format": "asset"
              },
              "ald.name": {
                "type": "string",
                "maxLength": 300
              },
              "ald.leftBanner": {
                "type": "string",
                "maxLength": 255,
                "format": "asset"
              },
              "ald.presetButtons": {
                "type": "string",
                "maxLength": 2000
              },
              "tokens": {
                "type": "object",
                "properties": {
                  "main": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string",
                      "maxLength": 500
                    },
                    "maxProperties": 100
                  },
                  "custom": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string",
                      "maxLength": 500
                    },
                    "maxProperties": 100
                  }
                },
                "required": [],
                "additionalProperties": false
              },
              "v2Checkout": {
                "type": "boolean"
              },
              "noModal": {
                "type": "boolean"
              },
              "noPromesse": {
                "type": "boolean"
              },
              "hideBar": {
                "type": "boolean"
              },
              "hideOrg": {
                "type": "boolean"
              },
              "autoDisplay": {
                "type": "boolean"
              },
              "forceCelebration": {
                "type": "boolean"
              },
              "fixedMontant": {
                "type": "boolean"
              },
              "noDefaultProduct": {
                "type": "boolean"
              },
              "giftAidBoost": {
                "type": "boolean"
              },
              "minMontant": {
                "type": "number",
                "minimum": 0.01,
                "maximum": 10000000,
                "multipleOf": 0.01
              },
              "productMonth": {
                "type": "boolean"
              },
              "maxNbMonth": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "minNbMonth": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "defaultNbMonth": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "forceMonthNb": {
                "type": "integer",
                "minimum": 0,
                "maximum": 120,
                "nullable": true
              },
              "maxDivideNB": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "monthlyAmountDisplay": {
                "type": "boolean"
              },
              "forceDivideGTEAmount": {
                "type": "number",
                "minimum": 0.01,
                "maximum": 10000000,
                "multipleOf": 0.01
              },
              "forceDivideNB": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "matched": {
                "type": "number",
                "minimum": 1,
                "maximum": 100
              },
              "currencies": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "devise": {
                      "type": "string",
                      "maxLength": 3,
                      "pattern": "^[a-z]{3}$"
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "REAL",
                        "VIRTUAL"
                      ]
                    },
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "assocId": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [
                    "devise",
                    "type"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 20
              },
              "categories": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 60
                },
                "maxItems": 20
              },
              "donorEmailTemplate": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              },
              "fr": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "en": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "he": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "de": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "it": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "es": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "pt": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "ru": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "gr": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "ro": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "fr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingCampaignRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### POST /fundraising-campaigns/{id}/duplicate

Dupliquer une campagne de dons

`duplicateFundraisingCampaign`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 120
          },
          "url": {
            "type": "string",
            "maxLength": 60,
            "pattern": "^campaign-[a-z0-9][a-z0-9-]{0,49}[a-z0-9]$"
          },
          "type": {
            "type": "string",
            "enum": [
              "AMOUNT",
              "COUNT",
              "PARTNER"
            ]
          },
          "objectif": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 1000000000,
            "multipleOf": 0.01
          },
          "matched": {
            "type": "number",
            "minimum": 1,
            "maximum": 100
          },
          "partnerMontant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "dateStart": {
            "type": "string",
            "maxLength": 40,
            "format": "date-time",
            "nullable": true
          },
          "dateEnd": {
            "type": "string",
            "maxLength": 40,
            "format": "date-time",
            "nullable": true
          },
          "donationPolicy": {
            "type": "string",
            "enum": [
              "OPEN",
              "SCHEDULED"
            ]
          },
          "bonus": {
            "type": "array",
            "items": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 10000000,
              "multipleOf": 0.01
            },
            "maxItems": 30
          },
          "gala": {
            "type": "boolean"
          },
          "ambs": {
            "type": "boolean"
          },
          "stockable": {
            "type": "boolean"
          },
          "tombola": {
            "type": "boolean",
            "deprecated": true,
            "description": "Alias historique de stockable. Conservé en lecture pour compatibilité ; utilisez stockable pour les nouvelles campagnes."
          },
          "presentCategories": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 60
            },
            "maxItems": 20
          },
          "ambsCategories": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 60
            },
            "maxItems": 20
          },
          "config": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "hidden": {
                      "type": "boolean"
                    },
                    "editable": {
                      "type": "boolean"
                    },
                    "contentType": {
                      "type": "string",
                      "enum": [
                        "EDITOR",
                        "AI"
                      ]
                    },
                    "aiContentBlockId": {
                      "type": "string",
                      "maxLength": 36,
                      "format": "uuid"
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "image": {
                      "type": "string",
                      "maxLength": 255,
                      "format": "asset"
                    },
                    "background": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "color": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "url": {
                      "type": "string",
                      "maxLength": 2000,
                      "format": "safe-url"
                    }
                  },
                  "required": [
                    "id",
                    "type"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "banners": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "maxLength": 36,
                      "format": "uuid"
                    },
                    "image": {
                      "type": "string",
                      "maxLength": 255,
                      "format": "asset"
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "DESKTOP",
                        "MOBILE"
                      ]
                    }
                  },
                  "required": [
                    "image",
                    "type"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 30
              },
              "metaImage": {
                "type": "string",
                "maxLength": 255,
                "format": "asset"
              },
              "banners.youtube": {
                "type": "string",
                "maxLength": 2000,
                "format": "safe-url"
              },
              "template": {
                "type": "string",
                "maxLength": 300
              },
              "designVariant": {
                "type": "string",
                "maxLength": 300,
                "description": "Mise en page de présentation V2. En cas de valeur absente, vide ou non prise en charge, le design standard actuel est utilisé. Indépendante des couleurs et du paiement ; conservée pour la compatibilité future."
              },
              "ambiance": {
                "type": "string",
                "maxLength": 300
              },
              "ald.logo": {
                "type": "string",
                "maxLength": 255,
                "format": "asset"
              },
              "ald.name": {
                "type": "string",
                "maxLength": 300
              },
              "ald.leftBanner": {
                "type": "string",
                "maxLength": 255,
                "format": "asset"
              },
              "ald.presetButtons": {
                "type": "string",
                "maxLength": 2000
              },
              "tokens": {
                "type": "object",
                "properties": {
                  "main": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string",
                      "maxLength": 500
                    },
                    "maxProperties": 100
                  },
                  "custom": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string",
                      "maxLength": 500
                    },
                    "maxProperties": 100
                  }
                },
                "required": [],
                "additionalProperties": false
              },
              "v2Checkout": {
                "type": "boolean"
              },
              "noModal": {
                "type": "boolean"
              },
              "noPromesse": {
                "type": "boolean"
              },
              "hideBar": {
                "type": "boolean"
              },
              "hideOrg": {
                "type": "boolean"
              },
              "autoDisplay": {
                "type": "boolean"
              },
              "forceCelebration": {
                "type": "boolean"
              },
              "fixedMontant": {
                "type": "boolean"
              },
              "noDefaultProduct": {
                "type": "boolean"
              },
              "giftAidBoost": {
                "type": "boolean"
              },
              "minMontant": {
                "type": "number",
                "minimum": 0.01,
                "maximum": 10000000,
                "multipleOf": 0.01
              },
              "productMonth": {
                "type": "boolean"
              },
              "maxNbMonth": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "minNbMonth": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "defaultNbMonth": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "forceMonthNb": {
                "type": "integer",
                "minimum": 0,
                "maximum": 120,
                "nullable": true
              },
              "maxDivideNB": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "monthlyAmountDisplay": {
                "type": "boolean"
              },
              "forceDivideGTEAmount": {
                "type": "number",
                "minimum": 0.01,
                "maximum": 10000000,
                "multipleOf": 0.01
              },
              "forceDivideNB": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "matched": {
                "type": "number",
                "minimum": 1,
                "maximum": 100
              },
              "currencies": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "devise": {
                      "type": "string",
                      "maxLength": 3,
                      "pattern": "^[a-z]{3}$"
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "REAL",
                        "VIRTUAL"
                      ]
                    },
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "assocId": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [
                    "devise",
                    "type"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 20
              },
              "categories": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 60
                },
                "maxItems": 20
              },
              "donorEmailTemplate": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              },
              "fr": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "en": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "he": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "de": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "it": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "es": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "pt": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "ru": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "gr": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "ro": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "fr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [
          "label",
          "url"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingCampaignRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### POST /fundraising-campaigns/{id}/publish

Publier une campagne de dons

`publishFundraisingCampaign`

Autorisation requise : `fundraising:publish`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:publish",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingCampaignRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:publish"
}
```

### POST /fundraising-campaigns/{id}/pause

Mettre en pause une campagne de dons

`pauseFundraisingCampaign`

Autorisation requise : `fundraising:publish`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:publish",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingCampaignRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:publish"
}
```

### POST /fundraising-campaigns/{id}/resume

Reprendre une campagne de dons

`resumeFundraisingCampaign`

Autorisation requise : `fundraising:publish`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:publish",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingCampaignRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:publish"
}
```

### POST /fundraising-campaigns/{id}/archive

Archiver une campagne de dons

`archiveFundraisingCampaign`

Autorisation requise : `fundraising:publish`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:publish",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingCampaignRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:publish"
}
```

### GET /fundraising-campaigns/{id}/config

Obtenir la configuration de collecte de dons

`getFundraisingConfiguration`

Autorisation requise : `fundraising:read`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingConfig"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:read"
}
```

### PATCH /fundraising-campaigns/{id}/config/{section}

Modifier la configuration de collecte de dons

`updateFundraisingConfiguration`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "section",
  "required": true,
  "schema": {
    "type": "string",
    "enum": [
      "content",
      "appearance",
      "donations",
      "currencies",
      "automation"
    ]
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "maxLength": 300
          },
          "description": {
            "type": "string",
            "maxLength": 50000
          },
          "donationButtonText": {
            "type": "string",
            "maxLength": 300
          },
          "donorName": {
            "type": "string",
            "maxLength": 300
          },
          "donorNameMulti": {
            "type": "string",
            "maxLength": 300
          },
          "sections": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 100
                },
                "type": {
                  "type": "string",
                  "maxLength": 100
                },
                "label": {
                  "type": "string",
                  "maxLength": 300
                },
                "hidden": {
                  "type": "boolean"
                },
                "editable": {
                  "type": "boolean"
                },
                "contentType": {
                  "type": "string",
                  "enum": [
                    "EDITOR",
                    "AI"
                  ]
                },
                "aiContentBlockId": {
                  "type": "string",
                  "maxLength": 36,
                  "format": "uuid"
                },
                "content": {
                  "type": "string",
                  "maxLength": 50000
                },
                "html": {
                  "type": "string",
                  "maxLength": 50000
                },
                "title": {
                  "type": "string",
                  "maxLength": 300
                },
                "description": {
                  "type": "string",
                  "maxLength": 50000
                },
                "image": {
                  "type": "string",
                  "maxLength": 255,
                  "format": "asset"
                },
                "background": {
                  "type": "string",
                  "maxLength": 100
                },
                "color": {
                  "type": "string",
                  "maxLength": 100
                },
                "url": {
                  "type": "string",
                  "maxLength": 2000,
                  "format": "safe-url"
                }
              },
              "required": [
                "id",
                "type"
              ],
              "additionalProperties": false
            },
            "maxItems": 50
          },
          "banners": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 36,
                  "format": "uuid"
                },
                "image": {
                  "type": "string",
                  "maxLength": 255,
                  "format": "asset"
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "DESKTOP",
                    "MOBILE"
                  ]
                }
              },
              "required": [
                "image",
                "type"
              ],
              "additionalProperties": false
            },
            "maxItems": 30
          },
          "metaImage": {
            "type": "string",
            "maxLength": 255,
            "format": "asset"
          },
          "banners.youtube": {
            "type": "string",
            "maxLength": 2000,
            "format": "safe-url"
          },
          "template": {
            "type": "string",
            "maxLength": 300
          },
          "designVariant": {
            "type": "string",
            "maxLength": 300,
            "description": "Mise en page de présentation V2. En cas de valeur absente, vide ou non prise en charge, le design standard actuel est utilisé. Indépendante des couleurs et du paiement ; conservée pour la compatibilité future."
          },
          "ambiance": {
            "type": "string",
            "maxLength": 300
          },
          "ald.logo": {
            "type": "string",
            "maxLength": 255,
            "format": "asset"
          },
          "ald.name": {
            "type": "string",
            "maxLength": 300
          },
          "ald.leftBanner": {
            "type": "string",
            "maxLength": 255,
            "format": "asset"
          },
          "ald.presetButtons": {
            "type": "string",
            "maxLength": 2000
          },
          "tokens": {
            "type": "object",
            "properties": {
              "main": {
                "type": "object",
                "additionalProperties": {
                  "type": "string",
                  "maxLength": 500
                },
                "maxProperties": 100
              },
              "custom": {
                "type": "object",
                "additionalProperties": {
                  "type": "string",
                  "maxLength": 500
                },
                "maxProperties": 100
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "v2Checkout": {
            "type": "boolean"
          },
          "noModal": {
            "type": "boolean"
          },
          "noPromesse": {
            "type": "boolean"
          },
          "hideBar": {
            "type": "boolean"
          },
          "hideOrg": {
            "type": "boolean"
          },
          "autoDisplay": {
            "type": "boolean"
          },
          "forceCelebration": {
            "type": "boolean"
          },
          "fixedMontant": {
            "type": "boolean"
          },
          "noDefaultProduct": {
            "type": "boolean"
          },
          "giftAidBoost": {
            "type": "boolean"
          },
          "minMontant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "productMonth": {
            "type": "boolean"
          },
          "maxNbMonth": {
            "type": "integer",
            "minimum": 1,
            "maximum": 120
          },
          "minNbMonth": {
            "type": "integer",
            "minimum": 1,
            "maximum": 120
          },
          "defaultNbMonth": {
            "type": "integer",
            "minimum": 1,
            "maximum": 120
          },
          "forceMonthNb": {
            "type": "integer",
            "minimum": 0,
            "maximum": 120,
            "nullable": true
          },
          "maxDivideNB": {
            "type": "integer",
            "minimum": 1,
            "maximum": 120
          },
          "monthlyAmountDisplay": {
            "type": "boolean"
          },
          "forceDivideGTEAmount": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "forceDivideNB": {
            "type": "integer",
            "minimum": 1,
            "maximum": 120
          },
          "matched": {
            "type": "number",
            "minimum": 1,
            "maximum": 100
          },
          "currencies": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "devise": {
                  "type": "string",
                  "maxLength": 3,
                  "pattern": "^[a-z]{3}$"
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "REAL",
                    "VIRTUAL"
                  ]
                },
                "label": {
                  "type": "string",
                  "maxLength": 300
                },
                "assocId": {
                  "type": "string",
                  "maxLength": 100
                }
              },
              "required": [
                "devise",
                "type"
              ],
              "additionalProperties": false
            },
            "maxItems": 20
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 60
            },
            "maxItems": 20
          },
          "donorEmailTemplate": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid",
            "nullable": true
          },
          "donorEmailSubject": {
            "type": "string",
            "maxLength": 200
          },
          "fr": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false,
        "description": "Champs partiels de la section sélectionnée : contenu, apparence, dons, devises ou automatisation. Seuls les champs de cette section sont enregistrés."
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingCampaignRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### GET /fundraising-campaigns/{id}/sections/{childId}/content

Obtenir le contenu d’une section de collecte

`getFundraisingSectionContent`

Autorisation requise : `fundraising:read`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingSectionContentRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:read"
}
```

### PATCH /fundraising-campaigns/{id}/sections/{childId}/content

Modifier le contenu d’une section de collecte

`updateFundraisingSectionContent`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "content": {
            "type": "string",
            "maxLength": 500000
          },
          "editVersion": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [
          "content",
          "editVersion"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingSectionContentRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### GET /fundraising-campaigns/{id}/public

Obtenir la version publique de la collecte

`getFundraisingPublic`

Autorisation requise : `fundraising:read`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "allOf": [
              {
                "$ref": "#/components/schemas/FundraisingCampaignRead"
              },
              {
                "type": "object",
                "properties": {
                  "progress": {
                    "$ref": "#/components/schemas/FundraisingProgress"
                  },
                  "teams": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/FundraisingteamsRead"
                    }
                  },
                  "sources": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/FundraisingsourcesRead"
                    }
                  },
                  "products": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/FundraisingproductsRead"
                    }
                  },
                  "counters": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/FundraisingcountersRead"
                    }
                  }
                }
              }
            ]
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:read"
}
```

### GET /fundraising-campaigns/{id}/progress

Obtenir la progression de la collecte

`getFundraisingProgress`

Autorisation requise : `fundraising:read`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingProgress"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:read"
}
```

### GET /fundraising-campaigns/{id}/donors

Obtenir les donateurs de la collecte

`getFundraisingDonors`

Autorisation requise : `fundraising:read`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "query",
  "name": "limit",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200
  }
}
```

```json
{
  "in": "query",
  "name": "cursor",
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FundraisingDonor"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:read"
}
```

### GET /fundraising-campaigns/{id}/stats

Obtenir les statistiques de la collecte

`getFundraisingStats`

Autorisation requise : `fundraising:read`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingProgress"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:read"
}
```

### GET /fundraising-campaigns/{id}/teams

Lister les équipes de collecte

`listFundraisingTeams`

Autorisation requise : `fundraising:read`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "query",
  "name": "limit",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200
  }
}
```

```json
{
  "in": "query",
  "name": "cursor",
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FundraisingteamsRead"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:read"
}
```

### POST /fundraising-campaigns/{id}/teams

Créer une équipe de collecte

`createFundraisingTeam`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 200
          },
          "param": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-z0-9][a-z0-9_-]*$"
          },
          "objectif": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "description": {
            "type": "string",
            "maxLength": 50000
          },
          "color": {
            "type": "string",
            "maxLength": 9,
            "pattern": "^#[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$"
          },
          "hidden": {
            "type": "boolean"
          },
          "fr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [
          "label",
          "param"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingteamsRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### GET /fundraising-campaigns/{id}/teams/{childId}

Obtenir une équipe de collecte

`getFundraisingTeam`

Autorisation requise : `fundraising:read`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingteamsRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:read"
}
```

### PATCH /fundraising-campaigns/{id}/teams/{childId}

Modifier une équipe de collecte

`updateFundraisingTeam`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 200
          },
          "param": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-z0-9][a-z0-9_-]*$"
          },
          "objectif": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "description": {
            "type": "string",
            "maxLength": 50000
          },
          "color": {
            "type": "string",
            "maxLength": 9,
            "pattern": "^#[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$"
          },
          "hidden": {
            "type": "boolean"
          },
          "fr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingteamsRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### DELETE /fundraising-campaigns/{id}/teams/{childId}

Supprimer une équipe de collecte

`deleteFundraisingTeam`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### GET /fundraising-campaigns/{id}/sources

Lister les sources de collecte

`listFundraisingSources`

Autorisation requise : `fundraising:read`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "query",
  "name": "limit",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200
  }
}
```

```json
{
  "in": "query",
  "name": "cursor",
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FundraisingsourcesRead"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:read"
}
```

### POST /fundraising-campaigns/{id}/sources

Créer une source de collecte

`createFundraisingSource`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 200
          },
          "param": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-z0-9][a-z0-9_-]*$"
          },
          "fr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [
          "label",
          "param"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingsourcesRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### GET /fundraising-campaigns/{id}/sources/{childId}

Obtenir une source de collecte

`getFundraisingSource`

Autorisation requise : `fundraising:read`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingsourcesRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:read"
}
```

### PATCH /fundraising-campaigns/{id}/sources/{childId}

Modifier une source de collecte

`updateFundraisingSource`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 200
          },
          "param": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-z0-9][a-z0-9_-]*$"
          },
          "fr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingsourcesRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### DELETE /fundraising-campaigns/{id}/sources/{childId}

Supprimer une source de collecte

`deleteFundraisingSource`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### GET /fundraising-campaigns/{id}/products

Lister les produits de collecte

`listFundraisingProducts`

Autorisation requise : `fundraising:read`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "query",
  "name": "limit",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200
  }
}
```

```json
{
  "in": "query",
  "name": "cursor",
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FundraisingproductsRead"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:read"
}
```

### POST /fundraising-campaigns/{id}/products

Créer un produit de collecte

`createFundraisingProduct`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 200
          },
          "description": {
            "type": "string",
            "maxLength": 50000
          },
          "montant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "image": {
            "type": "string",
            "maxLength": 255,
            "format": "asset"
          },
          "prices": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 10000000,
              "multipleOf": 0.01
            },
            "maxProperties": 20
          },
          "stock": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000
          },
          "position": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000
          },
          "fr": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [
          "name",
          "montant"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingproductsRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### GET /fundraising-campaigns/{id}/products/{childId}

Obtenir un produit de collecte

`getFundraisingProduct`

Autorisation requise : `fundraising:read`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingproductsRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:read"
}
```

### PATCH /fundraising-campaigns/{id}/products/{childId}

Modifier un produit de collecte

`updateFundraisingProduct`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 200
          },
          "description": {
            "type": "string",
            "maxLength": 50000
          },
          "montant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "image": {
            "type": "string",
            "maxLength": 255,
            "format": "asset"
          },
          "prices": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 10000000,
              "multipleOf": 0.01
            },
            "maxProperties": 20
          },
          "stock": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000
          },
          "position": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000
          },
          "fr": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingproductsRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### DELETE /fundraising-campaigns/{id}/products/{childId}

Supprimer un produit de collecte

`deleteFundraisingProduct`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### POST /fundraising-campaigns/{id}/products/positions

Réorganiser les produits de collecte

`orderFundraisingProducts`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "ids": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 36,
              "format": "uuid"
            },
            "maxItems": 200
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [
          "ids"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "reorder",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### GET /fundraising-campaigns/{id}/counters

Lister les compteurs de collecte

`listFundraisingCounters`

Autorisation requise : `fundraising:read`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "query",
  "name": "limit",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200
  }
}
```

```json
{
  "in": "query",
  "name": "cursor",
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FundraisingcountersRead"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:read"
}
```

### POST /fundraising-campaigns/{id}/counters

Créer un compteur de collecte

`createFundraisingCounter`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 200
          },
          "name": {
            "type": "string",
            "maxLength": 200
          },
          "description": {
            "type": "string",
            "maxLength": 50000
          },
          "nb": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          },
          "position": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000
          },
          "fr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [
          "label"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingcountersRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### GET /fundraising-campaigns/{id}/counters/{childId}

Obtenir un compteur de collecte

`getFundraisingCounter`

Autorisation requise : `fundraising:read`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingcountersRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:read"
}
```

### PATCH /fundraising-campaigns/{id}/counters/{childId}

Modifier un compteur de collecte

`updateFundraisingCounter`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 200
          },
          "name": {
            "type": "string",
            "maxLength": 200
          },
          "description": {
            "type": "string",
            "maxLength": 50000
          },
          "nb": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          },
          "position": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000
          },
          "fr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingcountersRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### DELETE /fundraising-campaigns/{id}/counters/{childId}

Supprimer un compteur de collecte

`deleteFundraisingCounter`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### POST /fundraising-campaigns/{id}/counters/positions

Réorganiser les compteurs de collecte

`orderFundraisingCounters`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "ids": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 36,
              "format": "uuid"
            },
            "maxItems": 200
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [
          "ids"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "reorder",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### GET /fundraising-campaigns/{id}/ambassadors

Lister les ambassadeurs de collecte

`listFundraisingAmbassadors`

Autorisation requise : `fundraising:read`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "query",
  "name": "limit",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200
  }
}
```

```json
{
  "in": "query",
  "name": "cursor",
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:read"
}
```

### POST /fundraising-campaigns/{id}/ambassadors

Attribuer un ambassadeur de collecte

`assignFundraisingAmbassador`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "contactId": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "teamId": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [
          "contactId",
          "teamId"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### DELETE /fundraising-campaigns/{id}/ambassadors/{childId}

Retirer un ambassadeur de collecte

`removeFundraisingAmbassador`

Autorisation requise : `fundraising:write`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### POST /fundraising-campaigns/{id}/checkouts

Créer une page de paiement de collecte

`createFundraisingCheckout`

Autorisation requise : `fundraising:checkout`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

Crée une URL de paiement Unisoft hébergée, à durée limitée, sans encaisser. RECURRING nécessite amountBasis MONTHLY ; INSTALLMENTS nécessite amountBasis TOTAL et un total divisible par installments. Les devises VIRTUAL sont uniquement destinées à l’affichage : envoyez la devise principale. C’est la confirmation du fournisseur qui détermine l’état COMPLETED ; returnUrl ne le détermine pas.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:checkout",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "amount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100000000
          },
          "devise": {
            "type": "string",
            "maxLength": 3,
            "pattern": "^[a-z]{3}$"
          },
          "mode": {
            "type": "string",
            "enum": [
              "ONCE",
              "RECURRING",
              "INSTALLMENTS"
            ]
          },
          "installments": {
            "type": "integer",
            "minimum": 1,
            "maximum": 120
          },
          "amountBasis": {
            "type": "string",
            "enum": [
              "MONTHLY",
              "TOTAL"
            ]
          },
          "returnUrl": {
            "type": "string",
            "maxLength": 2000,
            "format": "safe-url"
          },
          "participation": {
            "type": "object",
            "properties": {
              "team": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "source": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "displayName": {
                "type": "string",
                "maxLength": 200
              },
              "display": {
                "type": "boolean"
              },
              "comment": {
                "type": "string",
                "maxLength": 3000
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "reservationId": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [
          "amount",
          "devise"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingCheckoutRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:checkout"
}
```

### GET /fundraising-campaigns/{id}/checkouts/{childId}

Obtenir une page de paiement de collecte

`getFundraisingCheckout`

Autorisation requise : `fundraising:checkout`.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:checkout",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingCheckoutRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-scope": "fundraising:checkout"
}
```

### POST /fundraising-campaigns/{id}/checkouts/{childId}/cancel

Annuler une page de paiement de collecte

`cancelFundraisingCheckout`

Autorisation requise : `fundraising:checkout`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:checkout",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingCheckoutRead"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:checkout"
}
```

### POST /fundraising-campaigns/{id}/reservations

Réserver des produits de collecte

`reserveFundraisingProducts`

Autorisation requise : `fundraising:checkout`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:checkout",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "products": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 64,
                  "pattern": "^[A-Za-z0-9_-]{1,64}$"
                },
                "nb": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 10000
                }
              },
              "required": [
                "id",
                "nb"
              ],
              "additionalProperties": false
            },
            "maxItems": 50
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [
          "products"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": false,
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:checkout"
}
```

### DELETE /fundraising-campaigns/{id}/reservations/{childId}

Libérer des produits de collecte

`releaseFundraisingProducts`

Autorisation requise : `fundraising:checkout`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:checkout",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": false,
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:checkout"
}
```

### GET /fundraising-campaigns/{id}/payments

Lister les paiements de collecte

`listFundraisingPayments`

Autorisation requise : `fundraising:read`.

Nécessite également `paiements:read` (les deux autorisations sont vérifiées).

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": [
    "paiements:read"
  ]
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "query",
  "name": "limit",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200
  }
}
```

```json
{
  "in": "query",
  "name": "cursor",
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Paiement"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-additional-scopes": [
    "paiements:read"
  ],
  "x-unisoft-scope": "fundraising:read"
}
```

### GET /fundraising-campaigns/{id}/subscriptions

Lister les abonnements de collecte

`listFundraisingSubscriptions`

Autorisation requise : `fundraising:read`.

Nécessite également `abonnements:read` (les deux autorisations sont vérifiées).

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": [
    "abonnements:read"
  ]
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "query",
  "name": "limit",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200
  }
}
```

```json
{
  "in": "query",
  "name": "cursor",
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Abonnement"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-additional-scopes": [
    "abonnements:read"
  ],
  "x-unisoft-scope": "fundraising:read"
}
```

### POST /fundraising-campaigns/{id}/subscriptions/{childId}/cancel

Annuler un abonnement de collecte

`cancelFundraisingSubscription`

Autorisation requise : `fundraising:write`.

Nécessite également `abonnements:write` (les deux autorisations sont vérifiées).

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": [
    "abonnements:write"
  ]
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  },
  "x-unisoft-additional-scopes": [
    "abonnements:write"
  ],
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### GET /fundraising-campaigns/{id}/pledges

Lister les promesses de don de collecte

`listFundraisingPledges`

Autorisation requise : `fundraising:read`.

Nécessite également `promesses:read` (les deux autorisations sont vérifiées).

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": [
    "promesses:read"
  ]
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "query",
  "name": "limit",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 200
  }
}
```

```json
{
  "in": "query",
  "name": "cursor",
  "schema": {
    "type": "string"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Promesse"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-additional-scopes": [
    "promesses:read"
  ],
  "x-unisoft-scope": "fundraising:read"
}
```

### POST /fundraising-campaigns/{id}/pledges

Créer une promesse de don de collecte

`createFundraisingPledge`

Autorisation requise : `fundraising:write`.

Nécessite également `promesses:write` (les deux autorisations sont vérifiées).

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": [
    "promesses:write"
  ]
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "contactId": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "montant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "name": {
            "type": "string",
            "maxLength": 300
          },
          "occasion": {
            "type": "string",
            "maxLength": 300
          },
          "participation": {
            "type": "object",
            "properties": {
              "team": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "source": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "displayName": {
                "type": "string",
                "maxLength": 200
              },
              "display": {
                "type": "boolean"
              },
              "comment": {
                "type": "string",
                "maxLength": 3000
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [
          "contactId",
          "montant"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Promesse"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-additional-scopes": [
    "promesses:write"
  ],
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### GET /fundraising-campaigns/{id}/pledges/{childId}

Obtenir une promesse de don de collecte

`getFundraisingPledge`

Autorisation requise : `fundraising:read`.

Nécessite également `promesses:read` (les deux autorisations sont vérifiées).

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": [
    "promesses:read"
  ]
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Promesse"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-additional-scopes": [
    "promesses:read"
  ],
  "x-unisoft-scope": "fundraising:read"
}
```

### PATCH /fundraising-campaigns/{id}/pledges/{childId}

Modifier une promesse de don de collecte

`updateFundraisingPledge`

Autorisation requise : `fundraising:write`.

Nécessite également `promesses:write` (les deux autorisations sont vérifiées).

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": [
    "promesses:write"
  ]
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "contactId": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "montant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "name": {
            "type": "string",
            "maxLength": 300
          },
          "occasion": {
            "type": "string",
            "maxLength": 300
          },
          "participation": {
            "type": "object",
            "properties": {
              "team": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "source": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "displayName": {
                "type": "string",
                "maxLength": 200
              },
              "display": {
                "type": "boolean"
              },
              "comment": {
                "type": "string",
                "maxLength": 3000
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/Promesse"
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-additional-scopes": [
    "promesses:write"
  ],
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### POST /fundraising-campaigns/{id}/pledges/{childId}/cancel

Annuler une promesse de don de collecte

`cancelFundraisingPledge`

Autorisation requise : `fundraising:write`.

Nécessite également `promesses:write` (les deux autorisations sont vérifiées).

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": [
    "promesses:write"
  ]
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-additional-scopes": [
    "promesses:write"
  ],
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### POST /fundraising-campaigns/{id}/pledges/{childId}/payment-link

Créer le lien de paiement d’une promesse de don de collecte

`createFundraisingPledgePaymentLink`

Autorisation requise : `fundraising:write`.

Nécessite également `promesses:write` (les deux autorisations sont vérifiées).

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": [
    "promesses:write"
  ]
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-additional-scopes": [
    "promesses:write"
  ],
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### POST /fundraising-campaigns/{id}/offline-donations

Enregistrer un don de collecte hors ligne

`recordFundraisingOfflineDonation`

Autorisation requise : `fundraising:write`.

Nécessite également `paiements:write` (les deux autorisations sont vérifiées).

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

Enregistre des fonds déjà encaissés ; imported:true, sans émettre de reçu en double ni déclencher de prélèvement fournisseur. REST uniquement.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": [
    "paiements:write"
  ]
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "amount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100000000
          },
          "method": {
            "type": "string",
            "enum": [
              "CB",
              "VIREMENT",
              "CHEQUE",
              "PRELEVEMENT",
              "CASH",
              "NATURE"
            ]
          },
          "contactId": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "datetime": {
            "type": "string",
            "maxLength": 40,
            "format": "date-time",
            "nullable": true
          },
          "externalId": {
            "type": "string",
            "maxLength": 200
          },
          "participation": {
            "type": "object",
            "properties": {
              "team": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "source": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "displayName": {
                "type": "string",
                "maxLength": 200
              },
              "display": {
                "type": "boolean"
              },
              "comment": {
                "type": "string",
                "maxLength": 3000
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [
          "amount",
          "method"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": false,
  "x-unisoft-additional-scopes": [
    "paiements:write"
  ],
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### POST /fundraising-campaigns/{id}/manual-contributions

Créer une contribution manuelle à la collecte

`createFundraisingManualContribution`

Autorisation requise : `fundraising:write`.

Nécessite également `paiements:write` (les deux autorisations sont vérifiées).

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": [
    "paiements:write"
  ]
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "montant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "displayName": {
            "type": "string",
            "maxLength": 200
          },
          "comment": {
            "type": "string",
            "maxLength": 3000
          },
          "team": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid",
            "nullable": true
          },
          "source": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid",
            "nullable": true
          },
          "display": {
            "type": "boolean"
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [
          "montant"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-additional-scopes": [
    "paiements:write"
  ],
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### PATCH /fundraising-campaigns/{id}/manual-contributions/{childId}

Modifier une contribution manuelle à la collecte

`updateFundraisingManualContribution`

Autorisation requise : `fundraising:write`.

Nécessite également `paiements:write` (les deux autorisations sont vérifiées).

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": [
    "paiements:write"
  ]
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "montant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "displayName": {
            "type": "string",
            "maxLength": 200
          },
          "comment": {
            "type": "string",
            "maxLength": 3000
          },
          "team": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid",
            "nullable": true
          },
          "source": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid",
            "nullable": true
          },
          "display": {
            "type": "boolean"
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-additional-scopes": [
    "paiements:write"
  ],
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### DELETE /fundraising-campaigns/{id}/manual-contributions/{childId}

Supprimer une contribution manuelle à la collecte

`deleteFundraisingManualContribution`

Autorisation requise : `fundraising:write`.

Nécessite également `paiements:write` (les deux autorisations sont vérifiées).

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

`expectedRevision` est obligatoire ; `If-Match` est également accepté sur HTTP. Les anciens documents commencent à la révision 0. Une mise à jour en conflit renvoie 409.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:write",
  "additional": [
    "paiements:write"
  ]
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

```json
{
  "in": "header",
  "name": "If-Match",
  "schema": {
    "type": "string"
  },
  "description": "ETag de révision, obligatoire ici ou dans `expectedRevision` du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-additional-scopes": [
    "paiements:write"
  ],
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey",
    "expectedRevision"
  ],
  "x-unisoft-scope": "fundraising:write"
}
```

### PATCH /fundraising-campaigns/{id}/participations/{kind}/{childId}/display

Modérer une participation à la collecte

`moderateFundraisingParticipation`

Autorisation requise : `fundraising:moderate`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:moderate",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "path",
  "name": "kind",
  "required": true,
  "schema": {
    "type": "string",
    "enum": [
      "payment",
      "subscription",
      "pledge",
      "manual"
    ]
  }
}
```

```json
{
  "in": "path",
  "name": "childId",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "team": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid",
            "nullable": true
          },
          "source": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid",
            "nullable": true
          },
          "displayName": {
            "type": "string",
            "maxLength": 200
          },
          "display": {
            "type": "boolean"
          },
          "comment": {
            "type": "string",
            "maxLength": 3000
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:moderate"
}
```

### POST /fundraising-campaigns/{id}/visits

Enregistrer une visite liée à la collecte

`recordFundraisingVisit`

Autorisation requise : `fundraising:checkout`.

Chaque mutation nécessite une `idempotencyKey` (corps) ou un en-tête Idempotency-Key. Réutiliser une clé avec un corps différent renvoie 409. Toute opération en cours ou au résultat incertain doit être rapprochée ; ne réessayez pas un paiement avec une nouvelle clé.

Montants : le montant d’un paiement/checkout est un entier en unités mineures ; les objectifs de campagne, `montant` produit, `montant` de promesse et `montant` de contribution manuelle sont en unités majeures. AMOUNT correspond en interne à l’ancien type de campagne vide. Les indicateurs de progression (appariements, promesses, engagements récurrents et supplément Gift Aid) ne représentent pas des fonds encaissés.

FULL inclut le droit d’accès aux campagnes. Les autres forfaits permettant les pages nécessitent le module CAMPAGNE. Les clés API peuvent être limitées aux `fundraisingCampaignIds` ; une telle clé ne peut pas créer ni dupliquer une campagne. Les clés API privées doivent rester sur le serveur de votre site, jamais dans le JavaScript du navigateur.

Les surcharges de contenu suivent les langues activées de l’organisation ; la langue par défaut est à la racine. null supprime une surcharge de langue secondaire. Téléversez d’abord les images via /uploads ; les noms de fichiers doivent appartenir à cette organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "fundraising:checkout",
  "additional": []
}
```

#### Paramètres

```json
{
  "in": "path",
  "name": "id",
  "required": true,
  "schema": {
    "type": "string",
    "maxLength": 36,
    "format": "uuid"
  }
}
```

```json
{
  "in": "header",
  "name": "Idempotency-Key",
  "schema": {
    "type": "string",
    "maxLength": 200
  },
  "description": "Obligatoire ici ou dans la clé idempotencyKey du corps"
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "visitorId": {
            "type": "string",
            "maxLength": 100
          },
          "team": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "source": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "maxLength": 2000,
            "format": "safe-url"
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [
          "visitorId"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Succès",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object",
            "additionalProperties": true
          },
          "meta": {
            "$ref": "#/components/schemas/Pagination"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "Requête mal formée / clé d’idempotence manquante"
}
```

##### HTTP 403

```json
{
  "description": "Autorisation ou droit de campagne manquant"
}
```

##### HTTP 404

```json
{
  "description": "Campagne ou ressource inconnue (y compris une ressource d’une autre organisation)"
}
```

##### HTTP 409

```json
{
  "description": "Conflit de révision, d’état du cycle de vie, de stock ou d’idempotence"
}
```

##### HTTP 422

```json
{
  "description": "Erreur de validation ; champ indiqué"
}
```

##### HTTP 428

```json
{
  "description": "expectedRevision obligatoire"
}
```

##### HTTP 500

```json
{
  "description": "Échec inattendu ; rapprochez toute mutation dont le résultat est incertain"
}
```

#### OpenAPI

```json
{
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-required-mcp-fields": [
    "idempotencyKey"
  ],
  "x-unisoft-scope": "fundraising:checkout"
}
```

### GET /email-templates/catalog/variables

Lister les variables d’email prises en charge

`list_email_template_variables`

Autorisation système requise : `email_template_catalog:read`. Renvoie les seules variables qu’une IA peut utiliser. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_template_catalog:read",
  "additional": []
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EmailTemplateVariableCatalogue"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "CATALOG_SYSTEM_KEY_REQUIRED",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CATALOG_SYSTEM_KEY_REQUIRED"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_template_catalog:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /email-templates/catalog/assets

Téléverser une image pour les emails du catalogue

`upload_catalog_email_template_asset`

Autorisation système requise : `email_template_catalog:write`. Accepte une image PNG, JPEG ou WebP en base64, valide les véritables octets de l’image et renvoie une URL HTTPS stable à utiliser dans le HTML. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_template_catalog:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EmailTemplateCatalogAssetInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 201

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EmailTemplateCatalogAsset"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_template_catalog:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /email-templates/catalog

Lister les brouillons du catalogue et les modèles publiés

`list_catalog_email_templates`

Autorisation système requise : `email_template_catalog:read`. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_template_catalog:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "status",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "DRAFT",
      "PUBLISHED"
    ]
  }
}
```

```json
{
  "name": "language",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "search",
  "in": "query",
  "schema": {
    "type": "string",
    "maxLength": 100
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EmailTemplateCatalogItem"
            }
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_template_catalog:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /email-templates/catalog

Créer un brouillon complet du catalogue

`create_catalog_email_template`

Autorisation système requise : `email_template_catalog:write`. Crée ensemble le HTML et les métadonnées du catalogue, puis renvoie les résultats de validation. Le modèle reste en DRAFT jusqu’à sa publication explicite. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_template_catalog:write",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EmailTemplateCatalogCreateInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 201

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EmailTemplateCatalogItem"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "ERREUR_DE_VALIDATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "VALIDATION_ERROR"
          }
        }
      }
    }
  }
}
```

##### HTTP 403

```json
{
  "description": "CATALOG_SYSTEM_KEY_REQUIRED",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CATALOG_SYSTEM_KEY_REQUIRED"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_template_catalog:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /email-templates/catalog/{id}

Obtenir un modèle du catalogue et sa validation

`get_catalog_email_template`

Autorisation système requise : `email_template_catalog:read`. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_template_catalog:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EmailTemplateCatalogItem"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_template_catalog:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PATCH /email-templates/catalog/{id}

Modifier les métadonnées du catalogue

`update_catalog_email_template`

Autorisation système requise : `email_template_catalog:write`. Fait repasser le modèle à l’état DRAFT. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_template_catalog:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EmailTemplateCatalogUpdateInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EmailTemplateCatalogItem"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_template_catalog:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### DELETE /email-templates/catalog/{id}

Supprimer un modèle du catalogue

`delete_catalog_email_template`

Autorisation système requise : `email_template_catalog:write`. Supprime logiquement le modèle, qu’il soit en brouillon ou publié. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_template_catalog:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_template_catalog:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

### PUT /email-templates/catalog/{id}/content

Remplacer le HTML du catalogue

`update_catalog_email_template_content`

Autorisation système requise : `email_template_catalog:write`. Fait repasser le modèle à l’état DRAFT et renvoie les résultats de validation. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_template_catalog:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EmailTemplateCatalogContentInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EmailTemplateCatalogItem"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_template_catalog:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /email-templates/catalog/{id}/validate

Valider un modèle du catalogue

`validate_catalog_email_template`

Autorisation système requise : `email_template_catalog:read`. Vérifie les métadonnées obligatoires, les variables inconnues, le lien de désinscription, le HTML non sûr et les problèmes courants de mise en page des clients de messagerie. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_template_catalog:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EmailTemplateValidation"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_template_catalog:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /email-templates/catalog/{id}/preview-link

Créer une URL d’aperçu dans le navigateur

`create_catalog_email_template_preview_link`

Autorisation système requise : `email_template_catalog:read`. Renvoie une URL signée et l’objet/pré-en-tête rendu, valides de 1 à 60 minutes. L’aperçu de rédaction utilise une organisation synthétique sans risque et des valeurs d’exemple pour le destinataire ; la clé système ne lit donc aucune donnée client. Fonctionne pour les modèles DRAFT et PUBLISHED, y compris les brouillons comportant des erreurs de validation ou des avertissements de compatibilité. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_template_catalog:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EmailTemplatePreviewLinkInput"
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EmailTemplatePreviewLink"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

##### HTTP 503

```json
{
  "description": "EMAIL_TEMPLATE_PREVIEW_NOT_CONFIGURED",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "EMAIL_TEMPLATE_PREVIEW_NOT_CONFIGURED"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_template_catalog:read",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### POST /email-templates/catalog/{id}/publish

Publier un modèle du catalogue validé

`publish_catalog_email_template`

Autorisation système requise : `email_template_catalog:publish`. La publication est refusée si la validation contient une erreur. En cas de réussite, la version immuable du catalogue visible par les clients est incrémentée. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_template_catalog:publish",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EmailTemplateCatalogItem"
          }
        }
      }
    }
  }
}
```

##### HTTP 400

```json
{
  "description": "CATALOG_VALIDATION_FAILED",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CATALOG_VALIDATION_FAILED"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

##### HTTP 409

```json
{
  "description": "CATALOG_CHANGED_DURING_PUBLICATION",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CATALOG_CHANGED_DURING_PUBLICATION"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_template_catalog:publish",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### POST /email-templates/catalog/{id}/unpublish

Remettre un modèle du catalogue en brouillon

`unpublish_catalog_email_template`

Autorisation système requise : `email_template_catalog:publish`. Retire le modèle du catalogue client sans le supprimer. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_template_catalog:publish",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "object"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_template_catalog:publish",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /email-templates/library

Parcourir les modèles d’email publiés

`list_published_email_templates`

Autorisation requise : `email_templates:read`. Accessible à toutes les organisations. Renvoie uniquement les modèles PUBLISHED et indique si la version actuelle a déjà été importée dans l’organisation de l’appelant.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_templates:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "language",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "category",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "search",
  "in": "query",
  "schema": {
    "type": "string",
    "maxLength": 100
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EmailTemplateCatalogItem"
            }
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_templates:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /email-templates/library/{id}

Obtenir un modèle d’email publié

`get_published_email_template`

Autorisation requise : `email_templates:read`. Renvoie la source publiée, y compris ses variables HTML. Utilisez l’opération de lien d’aperçu pour l’afficher avec l’identité visuelle de l’organisation actuelle.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_templates:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EmailTemplateCatalogItem"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_templates:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### POST /email-templates/library/{id}/preview-link

Prévisualiser un modèle publié avec ma marque

`create_published_email_template_preview_link`

Autorisation requise : `email_templates:read`. Renvoie une URL de navigateur signée. L’organisation cible est toujours celle de la clé API et ne peut pas être remplacée.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_templates:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "expiresInSeconds": {
            "type": "integer",
            "minimum": 60,
            "maximum": 3600,
            "default": 900
          }
        }
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "OK",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EmailTemplatePreviewLink"
          }
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

##### HTTP 503

```json
{
  "description": "EMAIL_TEMPLATE_PREVIEW_NOT_CONFIGURED",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "EMAIL_TEMPLATE_PREVIEW_NOT_CONFIGURED"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_templates:read",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### POST /email-templates/library/{id}/import

Importer un modèle publié dans mon organisation

`import_published_email_template`

Autorisation requise : `email_templates:write`. Crée un modèle IA autonome dans l’organisation de l’appelant. Toutes les variables `{{org.*}}` sont résolues à partir de cette organisation ; les variables du destinataire restent à résoudre au moment de l’envoi. Importer deux fois la même version publiée est idempotent.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "email_templates:write",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
  },
  "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Déjà importé",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EmailTemplateImportResult"
      }
    }
  }
}
```

##### HTTP 201

```json
{
  "description": "Importé",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EmailTemplateImportResult"
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "NOT_FOUND"
          }
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "email_templates:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

### GET /wordpress/catalog

Lister le contenu public associé à l’organisation connectée

`list_wordpress_catalog`

Autorisation requise : `wordpress:read`. Métadonnées réservées à l’éditeur authentifié. Le contenu public est disponible automatiquement. resourceAccess est public ; le champ historique de sélection contient tous les identifiants renvoyés pour les anciens plugins. Ce n’est pas une opération anonyme destinée au navigateur.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "wordpress:read",
  "additional": []
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Projection publique uniquement ; jamais de données de donateur ou de soumission.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "wordpress:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### PUT /wordpress/selection

Enregistrer les préférences de contenu historique pour les anciens plugins

`update_wordpress_selection`

Autorisation requise : `wordpress:publish`. La connexion nécessite également wordpress:read. Les identifiants sont revérifiés par rapport aux ressources publiques de son organisation. Les préférences enregistrées ne restreignent plus l’accès au contenu public.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "wordpress:publish",
  "additional": []
}
```

#### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "selection"
        ],
        "properties": {
          "selection": {
            "type": "object",
            "properties": {
              "donation": {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "type": "string"
                }
              },
              "forms": {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "type": "string"
                }
              },
              "events": {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "type": "string"
                }
              },
              "caisses": {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "type": "string"
                }
              },
              "pages": {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "type": "string"
                }
              },
              "galleries": {
                "type": "array",
                "maxItems": 100,
                "items": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Projection publique uniquement ; jamais de données de donateur ou de soumission.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "deprecated": true,
  "x-unisoft-scope": "wordpress:publish",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /wordpress/data/{kind}

Lire les modules publics de l’organisation

`get_wordpress_data`

Autorisation requise : `wordpress:read`. L’appartenance à l’organisation et la disponibilité publique active sont vérifiées à chaque requête. Les montants sont des entiers en unités mineures, avec une devise par collection.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "wordpress:read",
  "additional": []
}
```

#### Paramètres

```json
{
  "name": "kind",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "enum": [
      "donation",
      "forms",
      "events",
      "caisses",
      "pages",
      "galleries"
    ]
  }
}
```

```json
{
  "name": "id",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "lang",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 24
  }
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Projection publique uniquement ; jamais de données de donateur ou de soumission.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

##### HTTP 404

```json
{
  "description": "Ressource indisponible, inactive ou appartenant à une autre organisation"
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "wordpress:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### DELETE /wordpress/connection

Déconnecter ce site WordPress

`delete_wordpress_connection`

Autorisation requise : `wordpress:read`. Supprime uniquement les paramètres de publication de cette clé ; révoque les jetons OAuth, mais ne révoque pas une clé d’intégration fournie manuellement.

#### Authentification

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

#### Permissions requises

```json
{
  "accepted": "wordpress:read",
  "additional": []
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Projection publique uniquement ; jamais de données de donateur ou de soumission.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {}
        }
      }
    }
  }
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": "wordpress:read",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

### GET /wordpress/releases/stable

Lire le manifeste signé de version du plugin

`list_wordpress_releases_stable`

Opération publique, indépendante de l’abonnement au compte. Construit et met automatiquement en cache la version du code déployée. Signature Ed25519 d’une charge utile JSON encodée en base64.

#### Authentification

```json
[]
```

#### Permissions requises

```json
{
  "accepted": null,
  "additional": []
}
```

#### Réponses

##### HTTP 200

```json
{
  "description": "Manifeste signé",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "required": [
          "signed",
          "signature"
        ],
        "properties": {
          "signed": {
            "type": "string"
          },
          "signature": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

##### HTTP 503

```json
{
  "description": "Génération de version temporairement indisponible ; réessayez plus tard"
}
```

#### OpenAPI

```json
{
  "x-unisoft-scope": null,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

### Schémas

````json
{
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INVALID_API_KEY"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "nextCursor": {
            "type": "string",
            "nullable": true
          },
          "hasMore": {
            "type": "boolean"
          },
          "count": {
            "type": "integer"
          }
        }
      },
      "Contact": {
        "type": "object",
        "description": "Un contact (donateur / membre) de l’organisation. Les champs d’identité sont à plat ; les sous-collections à valeurs multiples (adresses, téléphones et emails secondaires, balises, champs personnalisés, liens familiaux) sont des tableaux. Tous les champs `readOnly` sont calculés et ne sont jamais acceptés lors d’une écriture.",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "readOnly": true,
            "description": "UUID généré par le serveur. Utilisez-le comme `{id}` dans chaque chemin de sous-ressource."
          },
          "firstName": {
            "type": "string",
            "description": "Prénom. Enregistré avec une majuscule initiale (« david » → « David »)."
          },
          "lastName": {
            "type": "string",
            "description": "Nom de famille. Enregistré EN MAJUSCULES (« levy » → « LEVY »)."
          },
          "gender": {
            "type": "string",
            "enum": [
              "M",
              "F"
            ],
            "nullable": true,
            "description": "Genre : « M » (masculin) ou « F » (féminin), null = inconnu. Déduit de la civilité lors de l’importation — jamais deviné."
          },
          "email": {
            "type": "string",
            "description": "Email principal (en minuscules). Les emails supplémentaires se trouvent dans `secondaryEmails[]`."
          },
          "phone": {
            "type": "string",
            "description": "Téléphone principal au format E.164 (`+33612345678`). Les numéros supplémentaires se trouvent dans `secondaryPhones[]`."
          },
          "birthDate": {
            "type": "string",
            "format": "date",
            "nullable": true,
            "description": "Date de naissance, au format ISO `YYYY-MM-DD`."
          },
          "hebrewFirstName": {
            "type": "string",
            "description": "Prénom hébraïque."
          },
          "taxId": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant national / fiscal (par ex. Teudat Zehut israélienne). Déclaratif — aucune vérification auprès d’un registre."
          },
          "giftAid": {
            "type": "boolean",
            "description": "Indicateur d’éligibilité au Gift Aid britannique. Déclaratif."
          },
          "address": {
            "type": "string",
            "description": "Adresse principale — ligne de rue (à plat, sans identifiant)."
          },
          "postalCode": {
            "type": "string",
            "description": "Adresse principale — code postal."
          },
          "city": {
            "type": "string",
            "description": "Adresse principale — ville."
          },
          "region": {
            "type": "string",
            "description": "Adresse principale — état / région / province."
          },
          "country": {
            "type": "string",
            "description": "Adresse principale — pays."
          },
          "note": {
            "type": "string",
            "nullable": true,
            "description": "Note libre sur l’adresse principale."
          },
          "addresses": {
            "type": "array",
            "description": "Adresses SECONDAIRES (chacune avec un UUID `id` stable — modifiables via PATCH /contacts/{id}/addresses/{addressId}). L’adresse principale est représentée à plat par les champs `address`/`postalCode`/`city` ci-dessus et ne possède AUCUN identifiant.",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "format": "uuid",
                  "readOnly": true
                },
                "label": {
                  "type": "string",
                  "description": "Libellé libre de l’adresse (par ex. « Bureau »)."
                },
                "type": {
                  "type": "string",
                  "nullable": true,
                  "description": "PRO | PERSO (libellé libre)."
                },
                "address": {
                  "type": "string",
                  "description": "Ligne de rue."
                },
                "postalCode": {
                  "type": "string"
                },
                "city": {
                  "type": "string"
                },
                "region": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                },
                "companyId": {
                  "type": "string",
                  "nullable": true,
                  "description": "Numéro d’immatriculation de l’entreprise (pour une adresse PRO)."
                },
                "note": {
                  "type": "string",
                  "nullable": true
                }
              }
            }
          },
          "secondaryPhones": {
            "type": "array",
            "description": "Téléphones supplémentaires (E.164). Le numéro principal est `phone`.",
            "items": {
              "type": "object",
              "properties": {
                "phone": {
                  "type": "string"
                }
              }
            }
          },
          "secondaryEmails": {
            "type": "array",
            "description": "Emails supplémentaires. L’email principal est `email`.",
            "items": {
              "type": "object",
              "properties": {
                "email": {
                  "type": "string"
                }
              }
            }
          },
          "tags": {
            "type": "array",
            "description": "Balises de catégorie — étiquettes booléennes (en majuscules et sans accents, par ex. `DONATEUR`, `#FORM`). Ce ne sont PAS des champs personnalisés clé/valeur — voir `customFields[]`.",
            "items": {
              "type": "string"
            }
          },
          "customFields": {
            "type": "array",
            "description": "Champs personnalisés typés clé/valeur. Une entrée par clé (jamais de doublon). `type` vaut uniquement TEXT/DATE/BOOL — NUMBER/SELECT sont enregistrés en TEXT. À distinguer de `tags[]`.",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "readOnly": true
                },
                "key": {
                  "type": "string"
                },
                "type": {
                  "type": "string",
                  "description": "TEXT | DATE | BOOL"
                },
                "value": {
                  "nullable": true,
                  "description": "Valeur enregistrée (chaîne, date ISO ou booléen)."
                }
              }
            }
          },
          "familyLinks": {
            "type": "array",
            "description": "Liens familiaux. `contactId` = contact associé, `relationship` = SPOUSE/PARENT/CHILD/SIBLING/GRANDPARENT/GRANDCHILD/IN_LAW/EX/COUSIN/FRIEND. Bidirectionnels (le lien inverse se trouve sur l’autre contact).",
            "items": {
              "type": "object",
              "properties": {
                "relationship": {
                  "type": "string",
                  "enum": [
                    "SPOUSE",
                    "PARENT",
                    "CHILD",
                    "SIBLING",
                    "GRANDPARENT",
                    "GRANDCHILD",
                    "IN_LAW",
                    "EX",
                    "COUSIN",
                    "FRIEND"
                  ],
                  "nullable": true
                },
                "contactId": {
                  "type": "string",
                  "nullable": true
                }
              }
            }
          },
          "isLocal": {
            "type": "boolean",
            "readOnly": true,
            "description": "Indique si le contact est un contact de proximité « local » (habite dans la zone d’action de l’organisation) ; défini automatiquement ou manuellement."
          },
          "isLocalSource": {
            "type": "string",
            "nullable": true,
            "readOnly": true,
            "description": "Comment `isLocal` a été défini : AUTO | MANUAL | null."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Date de création."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Date de dernière modification."
          }
        }
      },
      "ContactCreateInput": {
        "type": "object",
        "description": "Identité d’un contact à CRÉER ou à INSÉRER/REMPLACER (UPSERT). Tous les champs sont facultatifs — un simple `phone` ou `email` suffit pour créer un contact utile. Formats : `gender` = « M » (masculin), « F » (féminin) ou null (inconnu — JAMAIS « Mr »/« Mme ») ; `phone` accepte une chaîne non normalisée (« 06 11 22 33 44 »), convertie au format E.164 ; `birthDate` au format ISO `YYYY-MM-DD` ; chaque entrée de `tags` est convertie en majuscules et sans accents (« Donateur régulier » → « DONATEUR_REGULIER »). Les `tags` sont des catégories booléennes ; `customFields` contient des champs typés clé/valeur — ne les confondez pas.",
        "required": [],
        "properties": {
          "firstName": {
            "type": "string",
            "description": "Prénom (enregistré avec une majuscule initiale)."
          },
          "lastName": {
            "type": "string",
            "description": "Nom de famille (enregistré EN MAJUSCULES)."
          },
          "gender": {
            "type": "string",
            "enum": [
              "M",
              "F"
            ],
            "nullable": true,
            "description": "« M » (masculin), « F » (féminin) ou null (inconnu). Jamais une civilité telle que « Mr »/« Mme »."
          },
          "email": {
            "type": "string",
            "description": "Email principal. Les emails non valides sont ignorés."
          },
          "phone": {
            "type": "string",
            "description": "Téléphone principal (n’importe quel format ; converti au format E.164). Fournissez `phoneCountry` pour les numéros locaux sans indicatif de pays."
          },
          "phoneCountry": {
            "type": "string",
            "description": "Code pays ISO 3166-1 alpha-2 (par ex. « FR », « IL ») utilisé pour normaliser un `phone`/`phones` local sans préfixe `+`."
          },
          "phones": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Téléphones supplémentaires (secondaires)."
          },
          "emails": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Emails supplémentaires (secondaires)."
          },
          "birthDate": {
            "type": "string",
            "format": "date",
            "description": "Date de naissance au format ISO `YYYY-MM-DD`. Lors d’un upsert, renseignée uniquement si vide (jamais remplacée)."
          },
          "hebrewFirstName": {
            "type": "string",
            "description": "Prénom hébraïque."
          },
          "taxId": {
            "type": "string",
            "description": "Identifiant national / fiscal (par ex. Teudat Zehut israélienne). Déclaratif."
          },
          "giftAid": {
            "type": "boolean",
            "description": "Indicateur Gift Aid britannique. Déclaratif."
          },
          "address": {
            "type": "string",
            "description": "Adresse postale principale. Si le contact possède déjà une adresse principale, celle-ci est ajoutée comme adresse secondaire."
          },
          "postalCode": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "region": {
            "type": "string",
            "description": "État / région / province."
          },
          "country": {
            "type": "string",
            "description": "Pays (par défaut : « France »)."
          },
          "note": {
            "type": "string",
            "description": "Note libre sur l’adresse principale."
          },
          "addresses": {
            "type": "array",
            "description": "Adresses SECONDAIRES supplémentaires à ajouter.",
            "items": {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string"
                },
                "type": {
                  "type": "string",
                  "description": "PRO | PERSO"
                },
                "address": {
                  "type": "string"
                },
                "postalCode": {
                  "type": "string"
                },
                "city": {
                  "type": "string"
                },
                "region": {
                  "type": "string"
                },
                "country": {
                  "type": "string"
                },
                "companyId": {
                  "type": "string",
                  "description": "Numéro d’immatriculation de l’entreprise (pour une adresse PRO)."
                },
                "note": {
                  "type": "string"
                }
              }
            }
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Balises de catégorie à associer (chacune normalisée EN MAJUSCULES). À la CRÉATION, la première balise sert de catégorie initiale ; en l’absence de balise, la balise source `#API` est définie."
          },
          "customFields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ContactFieldEntry"
            },
            "description": "Champs personnalisés typés clé/valeur (upsert par clé). Lors de la création/importation, ils ne renseignent que les champs vides (ajout uniquement). À distinguer de `tags[]`."
          }
        }
      },
      "ContactUpdateInput": {
        "type": "object",
        "description": "Champs d’identité à REMPLACER sur un contact existant (modification explicite — remplace la valeur enregistrée, contrairement à la création/upsert qui ne remplit que les champs vides). Les sous-collections (téléphones / emails / adresses secondaires, balises, champs personnalisés) ne sont PAS modifiées ici — utilisez les opérations dédiés aux sous-ressources. Une chaîne vide (\"\") signifie « ne pas modifier ». L’identité n’est jamais effacée. Mêmes formats que ContactCreateInput.",
        "required": [],
        "properties": {
          "firstName": {
            "type": "string",
            "description": "Remplace le prénom (majuscule initiale). \"\" = ne pas modifier."
          },
          "lastName": {
            "type": "string",
            "description": "Remplace le nom de famille (majuscules). \"\" = ne pas modifier."
          },
          "gender": {
            "type": "string",
            "enum": [
              "M",
              "F"
            ],
            "nullable": true,
            "description": "« M » (masculin), « F » (féminin) ou null (inconnu)."
          },
          "email": {
            "type": "string",
            "description": "Remplace l’email principal (doit être valide → 400 INVALID_EMAIL)."
          },
          "phone": {
            "type": "string",
            "description": "Remplace le téléphone principal (E.164 ; 400 INVALID_PHONE si impossible à analyser)."
          },
          "phoneCountry": {
            "type": "string",
            "description": "Pays ISO utilisé pour normaliser un `phone` local."
          },
          "birthDate": {
            "type": "string",
            "format": "date",
            "description": "Remplace la date de naissance (ISO). 400 INVALID_DATE si impossible à analyser."
          },
          "hebrewFirstName": {
            "type": "string",
            "description": "Remplace le prénom hébraïque."
          },
          "taxId": {
            "type": "string",
            "description": "Remplace l’identifiant national / fiscal (Teudat Zehut)."
          },
          "giftAid": {
            "type": "boolean",
            "description": "Remplace l’indicateur Gift Aid britannique."
          },
          "address": {
            "type": "string",
            "description": "Remplace l’adresse PRINCIPALE (rue)."
          },
          "postalCode": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "region": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "note": {
            "type": "string"
          }
        }
      },
      "ContactFieldEntry": {
        "type": "object",
        "description": "Champ personnalisé typé. À l’enregistrement, `type` est réduit à TEXT/DATE/BOOL — NUMBER/SELECT/etc. sont enregistrés comme TEXT (la valeur récupérée reste une chaîne).",
        "required": [
          "key"
        ],
        "properties": {
          "key": {
            "type": "string",
            "description": "Clé du champ (insensible à la casse ; `_` et `-` sont équivalents). Upsert par clé : écrire deux fois la même clé met à jour l’unique champ existant, sans jamais créer de doublon."
          },
          "type": {
            "type": "string",
            "enum": [
              "TEXT",
              "NUMBER",
              "DATE",
              "DATETIME",
              "BOOL"
            ],
            "description": "TEXT | NUMBER | DATE | DATETIME | BOOL. NUMBER/DATETIME sont enregistrés comme TEXT.",
            "default": "TEXT"
          },
          "value": {
            "description": "Valeur du champ (chaîne / nombre / date ISO / booléen)."
          }
        }
      },
      "ContactAddressInput": {
        "type": "object",
        "description": "Adresse à ajouter. Si le contact n’a pas d’adresse principale (ou si `main:true`), elle devient l’adresse principale ; sinon, elle est ajoutée comme adresse secondaire après dédoublonnage.",
        "required": [
          "address"
        ],
        "properties": {
          "main": {
            "type": "boolean",
            "description": "Définir cette adresse comme adresse PRINCIPALE (remplace celle à plat)."
          },
          "label": {
            "type": "string",
            "description": "Libellé libre (par ex. « Bureau »)."
          },
          "type": {
            "type": "string",
            "description": "PRO | PERSO."
          },
          "address": {
            "type": "string",
            "description": "Adresse (rue), obligatoire."
          },
          "postalCode": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "region": {
            "type": "string",
            "description": "État / région / province."
          },
          "country": {
            "type": "string",
            "description": "Pays (par défaut : « France »)."
          },
          "companyId": {
            "type": "string",
            "description": "Numéro d’immatriculation de l’entreprise (pour une adresse PRO)."
          },
          "note": {
            "type": "string"
          }
        }
      },
      "ContactAddressPatchInput": {
        "type": "object",
        "description": "Champs autorisés à fusionner dans une adresse SECONDAIRE (ciblée par son UUID `addressId`). Seuls les champs fournis sont modifiés. L’adresse PRINCIPALE n’a pas d’identifiant et ne peut pas être modifiée ici (utilisez PATCH /contacts/{id} ou POST /contacts/{id}/addresses avec main:true).",
        "properties": {
          "label": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "description": "PRO | PERSO."
          },
          "address": {
            "type": "string"
          },
          "postalCode": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "region": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "companyId": {
            "type": "string"
          },
          "note": {
            "type": "string"
          }
        }
      },
      "ContactPhoneInput": {
        "type": "object",
        "description": "Téléphone SECONDAIRE à ajouter (après dédoublonnage). Le téléphone principal se définit via POST/PATCH /contacts.",
        "required": [
          "phone"
        ],
        "properties": {
          "phone": {
            "type": "string",
            "description": "Téléphone (n’importe quel format ; normalisé en E.164 ; 400 INVALID_PHONE si impossible à analyser)."
          },
          "phoneCountry": {
            "type": "string",
            "description": "Code pays ISO utilisé pour normaliser un numéro local."
          }
        }
      },
      "ContactEmailInput": {
        "type": "object",
        "description": "Email SECONDAIRE à ajouter (après dédoublonnage). L’email principal se définit via POST/PATCH /contacts.",
        "required": [
          "email"
        ],
        "properties": {
          "email": {
            "type": "string",
            "description": "Email (en minuscules ; 400 INVALID_EMAIL s’il est invalide)."
          }
        }
      },
      "ContactTagsInput": {
        "type": "object",
        "description": "Une ou plusieurs catégories à associer (idempotent — ajouter à nouveau une balise ne fait rien). Chacune est normalisée (majuscules, sans accents, espaces remplacés par `_`). Les catégories système (#FORM/#PAIEMENT/#ABONNEMENT/#ACCOUNT/codes de devise) sont également autorisées. Une balise est une étiquette booléenne — PAS un champ personnalisé clé/valeur (voir ContactCustomFieldsInput).",
        "required": [
          "tags"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Balises, par ex. [\"Donateur\", \"Séder night\"] → enregistrées DONATEUR, SEDER_NIGHT."
          }
        }
      },
      "ContactCustomFieldsInput": {
        "type": "object",
        "description": "Champs personnalisés typés clé/valeur à mettre à jour par clé. `override` (true par défaut ici — modification explicite) remplace la valeur enregistrée ; définissez-le à false pour ne remplir que les champs vides. `type` est réduit à TEXT/DATE/BOOL (NUMBER/DATETIME sont enregistrés comme TEXT). À distinguer des catégories.",
        "required": [
          "customFields"
        ],
        "properties": {
          "customFields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ContactFieldEntry"
            },
            "description": "Champs à définir (upsert par clé, sans doublons)."
          },
          "override": {
            "type": "boolean",
            "description": "true (par défaut) remplace une valeur existante ; false ne remplit que les champs vides.",
            "default": true
          }
        }
      },
      "ContactFamilyLinkInput": {
        "type": "object",
        "description": "Lien familial bidirectionnel entre le contact et `relatedContactId`. Le lien inverse est ajouté automatiquement (PARENT↔CHILD et GRANDPARENT↔GRANDCHILD sont asymétriques ; les autres types sont symétriques). `relatedContactId` DOIT appartenir à la même organisation (sinon 404).",
        "required": [
          "relationship",
          "relatedContactId"
        ],
        "properties": {
          "relationship": {
            "type": "string",
            "enum": [
              "SPOUSE",
              "PARENT",
              "CHILD",
              "SIBLING",
              "GRANDPARENT",
              "GRANDCHILD",
              "IN_LAW",
              "EX",
              "COUSIN",
              "FRIEND"
            ],
            "description": "Lien DE ce contact VERS `relatedContactId` : SPOUSE, PARENT (ce contact est le parent → lien inverse CHILD), CHILD, SIBLING, GRANDPARENT (→ lien inverse GRANDCHILD), GRANDCHILD, IN_LAW, EX, COUSIN, FRIEND."
          },
          "relatedContactId": {
            "type": "string",
            "format": "uuid",
            "description": "Identifiant de l’autre contact (doit appartenir à l’organisation)."
          }
        }
      },
      "ContactInteraction": {
        "type": "object",
        "description": "Interaction consignée avec le contact (appel, visite, note). Projection en lecture d’un document `contact_activity`.",
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true
          },
          "type": {
            "type": "string",
            "description": "Type d’interaction, par ex. « Appel », « Visite »."
          },
          "content": {
            "type": "string",
            "description": "Notes en texte libre."
          },
          "actions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Balises textuelles facultatives décrivant ce qui a été fait."
          },
          "author": {
            "type": "string",
            "nullable": true,
            "readOnly": true,
            "description": "Nom du membre du personnel auteur lorsque l’entrée vient de l’admin/copilote ; null pour les entrées créées via l’API."
          },
          "datetime": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          }
        }
      },
      "ContactInteractionInput": {
        "type": "object",
        "description": "Nouvelle interaction à consigner pour le contact. Utilisez-la pour enregistrer un appel/une visite/une note depuis une automatisation. Pour rester cohérent, réutilisez un `type` de GET /contacts/{id}/interactions/types au lieu d’inventer un nouveau libellé à chaque fois.",
        "required": [
          "type"
        ],
        "properties": {
          "type": {
            "type": "string",
            "description": "Type d’interaction (libellé libre), par ex. « Appel », « Visite », « Rencontre »."
          },
          "content": {
            "type": "string",
            "description": "Notes libres sur l’interaction."
          },
          "actions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Balises textuelles facultatives, par ex. [« Tefiline », « Discussion »]."
          }
        }
      },
      "ContactChildInput": {
        "type": "object",
        "description": "Enfant en bas âge à rattacher au contact (et à son éventuel conjoint SPOUSE détecté) comme parent. Dédoublonnage par prénom parmi les enfants des parents : un enfant existant est réutilisé (created:false), sinon un nouveau contact enfant est créé sans téléphone ni email. Un lien PARENT↔CHILD est créé automatiquement.",
        "required": [
          "firstName"
        ],
        "properties": {
          "firstName": {
            "type": "string",
            "description": "Prénom de l’enfant (utilisé pour le dédoublonnage)."
          },
          "lastName": {
            "type": "string",
            "description": "Nom de famille de l’enfant (en majuscules)."
          },
          "birthDate": {
            "type": "string",
            "format": "date",
            "description": "Date de naissance (ISO)."
          }
        }
      },
      "ContactDocument": {
        "type": "object",
        "description": "Fichier joint au contact (reçu, scan d’une pièce d’identité, mandat signé…). Projection en lecture d’un sous-document `contact.docs[]`.",
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true,
            "description": "Identifiant du document (UUID) — transmettez-le à DELETE /contacts/{id}/documents/{docId}."
          },
          "name": {
            "type": "string",
            "nullable": true,
            "description": "Libellé lisible (par défaut, le nom de fichier si aucun n’a été fourni)."
          },
          "filename": {
            "type": "string",
            "nullable": true,
            "readOnly": true,
            "description": "Nom du fichier hébergé (md5.ext). Réutilisable pour joindre le MÊME fichier ailleurs sans le téléverser à nouveau."
          },
          "url": {
            "type": "string",
            "nullable": true,
            "readOnly": true,
            "description": "URL absolue de téléchargement du fichier."
          },
          "uploadedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          }
        }
      },
      "ContactDocumentInput": {
        "type": "object",
        "description": "Joindre un document au contact. Fournissez EXACTEMENT UN de ces éléments : `filename` (fichier déjà hébergé via POST /uploads/pdf|image) ou `url` (lien http(s), réhébergé côté serveur — image/PDF uniquement, parcours MCP/IA). Images et PDF uniquement (un document de contact est un scan, pas une vidéo). Parcours habituel : « téléverser d’abord, joindre ensuite » : POST /uploads/pdf → récupérer son `filename` → effectuer POST ici.",
        "properties": {
          "filename": {
            "type": "string",
            "description": "Nom du fichier hébergé renvoyé par POST /uploads/pdf ou POST /uploads/image (md5.ext). Il doit appartenir à cette organisation."
          },
          "url": {
            "type": "string",
            "description": "URL http(s) publique d’une image ou d’un PDF à télécharger et héberger. Utilisez-la depuis un agent MCP/IA qui ne peut pas transmettre un flux binaire."
          },
          "name": {
            "type": "string",
            "description": "Libellé facultatif du document (par défaut, le nom de fichier)."
          }
        }
      },
      "ContactNormalizeInput": {
        "type": "object",
        "description": "Lignes de colonnes brutes (issues d’Excel/CSV non nettoyés) à normaliser colonne par colonne. Opération PURE — aucune base de données ni donnée d’organisation n’est modifiée. À utiliser EN PREMIER lors de l’import d’un tableur : nettoie téléphone→E.164 (+ pays détecté), email, birthDate→ISO et civilité→gender « M »/« F », et signale les `issues` de chaque ligne.",
        "required": [
          "rows"
        ],
        "properties": {
          "rows": {
            "type": "array",
            "description": "Chaque objet contient les valeurs brutes des cellules d’une ligne du tableur.",
            "items": {
              "type": "object",
              "properties": {
                "phone": {
                  "type": "string",
                  "description": "Téléphone brut, par ex. \"06 12 34 56 78\"."
                },
                "email": {
                  "type": "string",
                  "description": "Email brut, par ex. \"David.Levy@GMAIL.com \"."
                },
                "birthDate": {
                  "type": "string",
                  "description": "Date de naissance brute, par ex. \"15/03/1990\" (JJ/MM/AAAA par défaut)."
                },
                "lastName": {
                  "type": "string"
                },
                "firstName": {
                  "type": "string"
                },
                "gender": {
                  "type": "string",
                  "description": "Civilité/genre brut, par ex. \"Mme\", \"Mr\", \"מר\", \"M\", \"F\" → genre \"M\"/\"F\"."
                },
                "category": {
                  "type": "string",
                  "description": "Balise de catégorie brute, par ex. \"Séder night\" → SEDER_NIGHT."
                }
              }
            }
          },
          "defaultPhoneCountry": {
            "type": "string",
            "description": "Pays ISO 3166-1 alpha-2 (par ex. \"FR\") pour normaliser les téléphones locaux sans indicatif de pays. Par défaut : \"ZZ\" (aucun)."
          },
          "dateFormat": {
            "type": "string",
            "description": "Indication pour les dates ambiguës (par ex. \"M/D/YYYY\" pour les fichiers américains). Les dates sont analysées avec un analyseur de dates, JAMAIS avec new Date(). Jour en premier (JJ/MM/AAAA) par défaut."
          }
        }
      },
      "ContactLookupInput": {
        "type": "object",
        "description": "Dédoublonnage par lot — pour chaque élément, rechercher le contact correspondant de l’organisation SANS rien écrire. À utiliser après la normalisation et avant l’import pour repérer les lignes déjà présentes (matchedContactId).",
        "required": [
          "items"
        ],
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "phone": {
                  "type": "string",
                  "description": "Téléphone à faire correspondre (normalisé en E.164 avant la recherche)."
                },
                "email": {
                  "type": "string",
                  "description": "Email à faire correspondre (converti en minuscules avant la recherche)."
                }
              }
            }
          },
          "defaultPhoneCountry": {
            "type": "string",
            "description": "Pays ISO utilisé pour normaliser les téléphones locaux. Par défaut : \"ZZ\"."
          }
        }
      },
      "ContactImportInput": {
        "type": "object",
        "description": "Upsert en masse de 500 contacts maximum (500+ → 400 IMPORT_TOO_LARGE ; répartir sur plusieurs pages). Définissez `dryRun:true` pour obtenir le PLAN détaillé par ligne (action + problèmes), SANS rien enregistrer. Chaque ligne est normalisée et validée comme avec create_contact ; toute ligne comportant une erreur bloquante est ignorée (action:\"error\"). Appelez d’abord get_contact_import_schema pour connaître les clés de champs importables et leurs alias.",
        "required": [
          "contacts"
        ],
        "properties": {
          "contacts": {
            "type": "array",
            "description": "Lignes à importer (≤ 500). Chaque ligne accepte les mêmes champs d’identité publics que ContactCreateInput (firstName/lastName/gender/email/phone/birthDate/tags/customFields/address…), ainsi qu’un `__row` facultatif (numéro de ligne source du tableur, renvoyé dans le rapport).",
            "items": {
              "allOf": [
                {
                  "$ref": "#/components/schemas/ContactCreateInput"
                },
                {
                  "type": "object",
                  "properties": {
                    "__row": {
                      "description": "Numéro d’origine de la ligne du tableur, renvoyé dans `report.lines[].row`."
                    }
                  }
                }
              ]
            }
          },
          "options": {
            "type": "object",
            "description": "Options d’importation.",
            "properties": {
              "dedupStrategy": {
                "type": "string",
                "enum": [
                  "skip",
                  "update",
                  "create"
                ],
                "description": "En cas de correspondance : ignorer (ne rien modifier), mettre à jour (ne remplir que les champs vides, par défaut) ou créer (toujours insérer un nouveau document).",
                "default": "update"
              },
              "applyTags": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Balises de catégorie ajoutées à CHAQUE contact importé (normalisées EN MAJUSCULES)."
              },
              "defaultPhoneCountry": {
                "type": "string",
                "description": "Pays ISO utilisé pour normaliser les téléphones locaux. Par défaut : \"ZZ\"."
              },
              "dateFormat": {
                "type": "string",
                "description": "Indication pour les dates ambiguës (par ex. \"M/D/YYYY\")."
              }
            }
          },
          "dryRun": {
            "type": "boolean",
            "description": "true = validation et planification uniquement, AUCUNE écriture. Les compteurs sont des PROJECTIONS ; `report.lines` indique l’action prévue pour chaque ligne.",
            "default": false
          }
        }
      },
      "ContactImportSchema": {
        "type": "object",
        "description": "Guide d’importation auto-descriptif : catalogue des champs importables (chacun avec ses alias permettant de faire correspondre les colonnes du tableur) et options d’importation disponibles. Appelez-le EN PREMIER, associez vos colonnes à ces clés de champ, puis exécutez : normalisation → recherche des correspondances → import dryRun → import.",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "fields": {
            "type": "array",
            "description": "Chaque champ public importable.",
            "items": {
              "type": "object",
              "properties": {
                "key": {
                  "type": "string",
                  "description": "Clé du champ public à utiliser dans les lignes de normalisation/import (par ex. \"firstName\", \"phone\", \"tags\")."
                },
                "label": {
                  "type": "string",
                  "description": "Libellé destiné à l’utilisateur."
                },
                "type": {
                  "type": "string",
                  "description": "string | enum | date | boolean | object[]."
                },
                "kind": {
                  "type": "string",
                  "enum": [
                    "identity",
                    "address",
                    "contact",
                    "tag",
                    "customField"
                  ],
                  "description": "Partie du contact alimentée par ce champ."
                },
                "multi": {
                  "type": "boolean",
                  "description": "Indique si le champ accepte plusieurs valeurs (par ex. tags, téléphones secondaires)."
                },
                "example": {
                  "description": "Valeur d’exemple."
                },
                "description": {
                  "type": "string"
                },
                "aliases": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "En-têtes de colonnes courants des tableurs FR/EN correspondant à ce champ — utilisez-les pour associer automatiquement vos colonnes."
                }
              }
            }
          },
          "options": {
            "type": "object",
            "description": "Options d’importation (dedupStrategy, defaultPhoneCountry, dateFormat, requireContact, applyTags), avec leurs valeurs autorisées et valeurs par défaut ; elles reprennent l’étape d’import de la page ImportPage de l’admin.",
            "additionalProperties": true
          }
        }
      },
      "ImportResult": {
        "type": "object",
        "description": "Résultat de l’importation. Même structure pour une simulation et un import réel : en mode simulation, les compteurs sont des PROJECTIONS et rien n’est enregistré ; `report.lines` est toujours présent (plan détaillé par ligne).",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "report": {
            "type": "object",
            "properties": {
              "created": {
                "type": "integer",
                "description": "Contacts créés (projection en mode simulation)."
              },
              "updated": {
                "type": "integer",
                "description": "Contacts mis à jour (projection en mode simulation)."
              },
              "skipped": {
                "type": "integer",
                "description": "Lignes ignorées (correspondance trouvée + dedupStrategy skip)."
              },
              "errors": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "row": {
                      "description": "__row ou index."
                    },
                    "reason": {
                      "description": "Problèmes bloquants de cette ligne."
                    }
                  }
                }
              },
              "warnings": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "row": {},
                    "reason": {
                      "type": "string"
                    }
                  }
                }
              },
              "lines": {
                "type": "array",
                "description": "Une entrée par ligne d’entrée (simulation ET import réel).",
                "items": {
                  "type": "object",
                  "properties": {
                    "row": {
                      "description": "__row (si fourni) ou index à partir de 0."
                    },
                    "action": {
                      "type": "string",
                      "enum": [
                        "create",
                        "update",
                        "skip",
                        "error"
                      ],
                      "description": "Action prévue/effectuée. \"error\" = problème bloquant → aucune écriture."
                    },
                    "matchedContactId": {
                      "type": "string",
                      "nullable": true,
                      "description": "Contact existant détecté lors du dédoublonnage (null = nouveau)."
                    },
                    "issues": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "field": {
                            "type": "string",
                            "description": "Champ PUBLIC concerné par le problème (par ex. \"phone\", \"email\", \"birthDate\")."
                          },
                          "reason": {
                            "type": "string",
                            "description": "MISSING_IDENTITY | INVALID_PHONE | INVALID_EMAIL | INVALID_DATE | INVALID_BOOL | DUPLICATE_IN_BATCH | UNKNOWN_RELATIONSHIP."
                          },
                          "severity": {
                            "type": "string",
                            "enum": [
                              "error",
                              "warning"
                            ],
                            "description": "error bloque l’écriture ; warning ne la bloque pas."
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "NormalizeResult": {
        "type": "object",
        "description": "Résultat de normalisation pour chaque ligne. Consultez `valid`/`country` pour chaque colonne afin de déterminer les corrections à apporter avant l’importation.",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "rows": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "index": {
                  "type": "integer"
                },
                "phone": {
                  "type": "object",
                  "properties": {
                    "input": {
                      "type": "string"
                    },
                    "e164": {
                      "type": "string",
                      "nullable": true
                    },
                    "national": {
                      "type": "string",
                      "nullable": true
                    },
                    "country": {
                      "type": "string",
                      "nullable": true
                    },
                    "valid": {
                      "type": "boolean"
                    }
                  }
                },
                "email": {
                  "type": "object",
                  "properties": {
                    "input": {
                      "type": "string"
                    },
                    "value": {
                      "type": "string",
                      "nullable": true
                    },
                    "valid": {
                      "type": "boolean"
                    }
                  }
                },
                "birthDate": {
                  "type": "object",
                  "properties": {
                    "input": {
                      "type": "string"
                    },
                    "value": {
                      "type": "string",
                      "nullable": true,
                      "description": "Date ISO."
                    },
                    "valid": {
                      "type": "boolean"
                    }
                  }
                },
                "lastName": {
                  "type": "string",
                  "nullable": true
                },
                "firstName": {
                  "type": "string",
                  "nullable": true
                },
                "gender": {
                  "type": "string",
                  "enum": [
                    "M",
                    "F"
                  ],
                  "nullable": true,
                  "description": "Déduit de la colonne de civilité/genre brute. null si non reconnu."
                },
                "civilityMatched": {
                  "type": "boolean",
                  "description": "Indique si la chaîne de civilité/genre brute a été reconnue."
                },
                "tags": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Balises de catégorie normalisées et déduites de la ligne."
                },
                "issues": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "field": {
                        "type": "string"
                      },
                      "reason": {
                        "type": "string"
                      },
                      "severity": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "LookupResult": {
        "type": "object",
        "description": "Résultat de la recherche groupée. Chaque élément indique le contact correspondant éventuel, sans aucune écriture.",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "index": {
                  "type": "integer"
                },
                "matchedContactId": {
                  "type": "string",
                  "nullable": true
                },
                "matchedOn": {
                  "type": "string",
                  "nullable": true,
                  "description": "\"phone\" ou \"email\"."
                },
                "matchedName": {
                  "type": "string",
                  "nullable": true
                }
              }
            }
          },
          "summary": {
            "type": "object",
            "properties": {
              "matched": {
                "type": "integer"
              },
              "unmatched": {
                "type": "integer"
              }
            }
          }
        }
      },
      "Paiement": {
        "type": "object",
        "description": "Un paiement (don, cotisation, paiement de formulaire, etc.). Les champs supplémentaires dépendent du fournisseur et du type de paiement.",
        "properties": {
          "externalRef": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "pattern": "\\S",
            "example": "commande-1234",
            "description": "Référence facultative dans votre système. Non vide, enregistrée telle quelle ; correspondance exacte sensible à la casse. Non unique et ne constitue PAS une clé d’idempotence. À distinguer de externalId (dédoublonnage à l’import). Renvoyée lors de la lecture des paiements et dans les webhooks de paiement si elle est fournie. Héritée par les paiements récurrents."
          },
          "externalMetadata": {
            "type": "object",
            "maxProperties": 50,
            "additionalProperties": {
              "type": "string",
              "maxLength": 500
            },
            "example": {
              "registrationId": "inscription-567",
              "eventId": "chabbat-890"
            },
            "description": "Carte facultative de chaînes clé-valeur gérée par l’appelant. Jusqu’à 50 clés (1–64 caractères chacune), valeurs de 500 caractères maximum. Les clés ne peuvent contenir . ou $, ni le caractère NUL, et ne peuvent être égales à __proto__, prototype ou constructor. Les valeurs null, tableaux, objets imbriqués et valeurs non textuelles sont refusés. Enregistrée telle quelle et renvoyée lors de la lecture des paiements et dans les webhooks ; héritée par les paiements récurrents. Distincte des métadonnées du fournisseur ; évitez d’y placer des secrets. Aucun de ces champs n’est obligatoire pour les paiements historiques."
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "typeId": {
            "type": "string",
            "nullable": true
          },
          "method": {
            "type": "string"
          },
          "refund": {
            "type": "object",
            "description": "Présent lorsqu’un remboursement a été demandé ; détails dépendant du fournisseur. Un remboursement confirmé a l’état SUCCEEDED.",
            "properties": {
              "state": {
                "type": "string"
              },
              "reason": {
                "type": "string"
              },
              "createdAt": {
                "type": "string",
                "format": "date-time"
              },
              "updatedAt": {
                "type": "string",
                "format": "date-time"
              }
            }
          },
          "id": {
            "type": "string"
          },
          "organisation": {
            "type": "string"
          },
          "state": {
            "type": "string",
            "enum": [
              "PENDING",
              "COMPLETED",
              "FAILED",
              "REFUNDED",
              "REFUND_PENDING",
              "CANCELED"
            ]
          },
          "type": {
            "type": "string",
            "enum": [
              "GENERAL",
              "SERVICE",
              "CAISSE",
              "DETTE",
              "FORM",
              "CAMPAGNE"
            ]
          },
          "platform": {
            "type": "string"
          },
          "amount": {
            "type": "integer",
            "description": "Montant en unités mineures (centimes)"
          },
          "devise": {
            "type": "string",
            "example": "EUR",
            "description": "Code de devise"
          },
          "contact": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant du contact, lorsqu’il est identifié (pas un objet contact imbriqué)."
          },
          "info": {
            "$ref": "#/components/schemas/PaiementInfo"
          },
          "datetime": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "PaiementInfo": {
        "type": "object",
        "nullable": true,
        "description": "Instantané de l’identité du donateur enregistrée sur le paiement (qui a donné). **Entièrement facultatif** — envoyez `null`, `{}` ou omettez-le pour un donateur anonyme/inconnu ; chaque sous-champ est également facultatif.\n\nRègles d’enregistrement : si AU MOINS un champ est renseigné, l’objet est enregistré au complet (les autres champs deviennent des chaînes vides, jamais null) ; si TOUS les champs sont vides, il est enregistré comme `null`, ce qui signifie « aucun contact donateur » et empêche l’envoi du reçu par EMAIL (le document du reçu est tout de même produit). `email` est l’adresse à laquelle le reçu est envoyé — sans elle, le donateur ne reçoit aucun email.\n\nUn seul cas est refusé (400 INVALID_INFO) : l’envoi d’une valeur qui n’est pas un objet, par ex. une chaîne ou un tableau. Cela indique toujours une erreur d’intégration (chaîne JSON non analysée), jamais un véritable donateur.",
        "properties": {
          "nom": {
            "type": "string",
            "description": "Nom de famille."
          },
          "prenom": {
            "type": "string",
            "description": "Prénom."
          },
          "email": {
            "type": "string",
            "description": "Adresse email à laquelle le reçu du paiement est envoyé."
          },
          "tel": {
            "type": "string",
            "description": "Numéro de téléphone (format E.164 recommandé)."
          }
        }
      },
      "PaiementFacturation": {
        "type": "object",
        "nullable": true,
        "description": "Identité de facturation/fiscale IMPRIMÉE SUR LE REÇU et le reçu fiscal (cerfa). **Entièrement facultative** — envoyez `null`, `{}` ou omettez-la ; chaque champ sera enregistré comme une chaîne vide (jamais null), ce qui permet de générer le reçu, mais celui-ci sera imprimé sans adresse. Chaque sous-champ est également facultatif. Renseignez-la TOUJOURS lorsque le don ouvre droit à un reçu fiscal, sans quoi le document sera vierge et inutilisable par le donateur.\n\n`perso` est le discriminant : `true` (par défaut) = particulier, le reçu est établi au nom de `nom` + `prenom` ; `false` = entreprise, le reçu est établi au nom de `raison` — fournissez TOUJOURS `raison` avec `perso:false`, sinon le reçu de l’entreprise portera un nom vide (accepté, mais inutilisable par le donateur). Lorsque `perso` est true et que `nom`/`prenom` sont omis, ils sont copiés depuis `info` si présents.\n\nDeux cas sont refusés (400 INVALID_FACTURATION) ; ils indiquent toujours une erreur d’intégration, pas un véritable don : envoyer une valeur qui n’est pas un objet (une chaîne ou un tableau au lieu du bloc), ou envoyer une valeur non booléenne pour `perso` (par ex. `1`, `0` ou `\"yes\"` — auparavant ces valeurs étaient interprétées silencieusement comme `true`, émettant un reçu de particulier pour une entreprise). Les champs texte fournis sous forme booléenne sont traités comme vides, de sorte que le mot \"false\" ne peut jamais être imprimé sur un reçu ; les nombres sont acceptés et convertis (`postal: 75001` → `\"75001\"`).",
        "properties": {
          "perso": {
            "type": "boolean",
            "default": true,
            "description": "true = particulier (nom/prenom), false = entreprise (raison/siren). Valeur par défaut : true."
          },
          "nom": {
            "type": "string",
            "description": "Nom de famille imprimé sur le reçu (particulier)."
          },
          "prenom": {
            "type": "string",
            "description": "Prénom imprimé sur le reçu (particulier)."
          },
          "civilite": {
            "type": "string",
            "description": "Civilité (M., Mme…) imprimée sur le reçu fiscal."
          },
          "raison": {
            "type": "string",
            "description": "Raison sociale. OBLIGATOIRE si perso est false — c’est le seul nom imprimé sur un reçu d’entreprise."
          },
          "siren": {
            "type": "string",
            "description": "Numéro d’immatriculation de l’entreprise (SIREN), imprimé à côté de sa raison sociale."
          },
          "adresse": {
            "type": "string",
            "description": "Adresse (rue) imprimée sur le reçu et synchronisée avec le contact CRM."
          },
          "postal": {
            "type": "string",
            "description": "Code postal."
          },
          "ville": {
            "type": "string",
            "description": "Ville."
          },
          "etat": {
            "type": "string",
            "description": "État / province. Imprimé sur le format de reçu canadien (CA) et synchronisé avec le CRM."
          },
          "pays": {
            "type": "string",
            "description": "Nom du pays. Utilisé par certains fournisseurs de paiement pour déterminer le code pays ISO."
          },
          "social_id": {
            "type": "string",
            "description": "Identifiant national (par ex. Teoudat Zehout) — utilisé par les plateformes de reçus israéliennes et synchronisé avec le contact CRM."
          },
          "giftAid": {
            "type": "boolean",
            "description": "Royaume-Uni uniquement : le donateur a accepté le Gift Aid. Active l’indicateur Gift Aid sur le contact CRM pour permettre à l’organisme de récupérer l’allègement fiscal. Omettez ce champ pour les dons hors Royaume-Uni."
          }
        }
      },
      "PaiementImportInput": {
        "type": "object",
        "description": "Don déjà encaissé à enregistrer comme paiement HISTORIQUE/comptable (chèque, virement, espèces, ancien logiciel ou autre plateforme). Il est enregistré avec `imported:true` et `state:\"COMPLETED\"` (forcés côté serveur) : il alimente les statistiques, compteurs de campagne, CRM et conversions de devise, mais aucun reçu/cerfa n’est émis de nouveau — le donateur l’a déjà reçu lors de l’encaissement. Utilisez cette opération pour migrer des paiements historiques ou consigner un don effectué hors plateforme ; utilisez plutôt `POST /paiements` pour qu’un donateur paie en ligne maintenant.",
        "required": [
          "method"
        ],
        "properties": {
          "externalRef": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255,
            "pattern": "\\S",
            "example": "commande-1234",
            "description": "Référence facultative dans votre système. Non vide, enregistrée telle quelle ; correspondance exacte sensible à la casse. Non unique et ne constitue PAS une clé d’idempotence. À distinguer de externalId (dédoublonnage à l’import). Renvoyée lors de la lecture des paiements et dans les webhooks de paiement si elle est fournie. Héritée par les paiements récurrents."
          },
          "externalMetadata": {
            "type": "object",
            "maxProperties": 50,
            "additionalProperties": {
              "type": "string",
              "maxLength": 500
            },
            "example": {
              "registrationId": "inscription-567",
              "eventId": "chabbat-890"
            },
            "description": "Carte facultative de chaînes clé-valeur gérée par l’appelant. Jusqu’à 50 clés (1–64 caractères chacune), valeurs de 500 caractères maximum. Les clés ne peuvent contenir . ou $, ni le caractère NUL, et ne peuvent être égales à __proto__, prototype ou constructor. Les valeurs null, tableaux, objets imbriqués et valeurs non textuelles sont refusés. Enregistrée telle quelle et renvoyée lors de la lecture des paiements et dans les webhooks ; héritée par les paiements récurrents. Distincte des métadonnées du fournisseur ; évitez d’y placer des secrets. Aucun de ces champs n’est obligatoire pour les paiements historiques."
          },
          "amount": {
            "type": "integer",
            "description": "Montant en unités mineures (centimes), par ex. 1500 = 15 €. Fournissez CE champ ou `montant` (pas les deux — `amount` est prioritaire). Doit être > 0."
          },
          "montant": {
            "type": "number",
            "description": "Montant en unités majeures de la devise, par ex. 50 = 50 € (comme le saisirait une personne). Converti en centimes côté serveur. Fournissez CE champ ou `amount`."
          },
          "method": {
            "type": "string",
            "enum": [
              "CB",
              "VIREMENT",
              "CHEQUE",
              "PRELEVEMENT",
              "CASH",
              "NATURE"
            ],
            "description": "Moyen de paiement. CB = carte/en ligne, VIREMENT = virement, CHEQUE = chèque, PRELEVEMENT = prélèvement bancaire, CASH = espèces, NATURE = don en nature. Les alias courants (wire/check/cash…) sont acceptés et normalisés."
          },
          "assoc": {
            "type": "string",
            "default": "MAIN",
            "description": "Association de l’organisation à laquelle ce don est rattaché — elle DÉTERMINE la devise et le reçu. Valeur par défaut : \"MAIN\". Consultez GET /associations pour les valeurs valides. `devise` en est toujours dérivée (ne peut pas être remplacée)."
          },
          "contactId": {
            "type": "string",
            "description": "Identifiant facultatif d’un contact CRM (de CETTE organisation) auquel rattacher le don. Aucun contact n’est créé implicitement — fournissez un identifiant existant ou omettez ce champ."
          },
          "type": {
            "type": "string",
            "enum": [
              "GENERAL",
              "CAMPAGNE",
              "DETTE",
              "CAISSE",
              "FORM"
            ],
            "default": "GENERAL",
            "description": "Type de rattachement. GENERAL (par défaut) = don simple. Sinon, rattachez à une entité de l’organisation via `typeId` : CAMPAGNE (alimente son compteur), DETTE (promesse de don), CAISSE, FORM (soumission). Le rattachement ne modifie PAS la devise (`assoc` la détermine)."
          },
          "typeId": {
            "type": "string",
            "description": "Identifiant de l’entité cible lorsque `type` ≠ GENERAL (campagne / dette / cagnotte / identifiant forms_submit). Doit appartenir à votre organisation."
          },
          "info": {
            "$ref": "#/components/schemas/PaiementInfo"
          },
          "facturation": {
            "$ref": "#/components/schemas/PaiementFacturation"
          },
          "commentaire": {
            "type": "string",
            "description": "Note en texte libre conservée sur le paiement."
          },
          "datetime": {
            "type": "string",
            "format": "date-time",
            "description": "Facultatif. Date RÉELLE d’encaissement du don, au format ISO 8601 (\"2024-01-15\" ou \"2024-01-15T10:30:00Z\") ; par défaut, la date actuelle si omise. À renseigner TOUJOURS lors d’une migration d’historique : cette date détermine l’ANNÉE FISCALE du reçu et sa séquence de numérotation ; une date erronée émet le reçu pour la mauvaise année. Si elle est fournie, elle doit être valide et ne pas être dans le futur — une valeur illisible (par ex. \"15/01/2024\", ambiguë, ou du texte libre) est refusée avec 400 INVALID_DATETIME au lieu d’être remplacée silencieusement par la date du jour ; une date future est refusée avec 400 DATETIME_IN_FUTURE (les dates jusqu’à 24h dans le futur sont tolérées pour compenser le décalage d’horloge du client)."
          },
          "source": {
            "type": "string",
            "default": "API_IMPORT",
            "description": "Libellé identifiant la provenance du paiement (par ex. \"HELLOASSO\", \"MY_OLD_SOFTWARE\"). Converti en majuscules. Valeur par défaut : \"API_IMPORT\"."
          },
          "externalId": {
            "type": "string",
            "description": "Votre référence stable pour ce paiement dans le système source. Lorsqu’elle est fournie, l’import est IDEMPOTENT : renvoyer le même externalId met à jour le même paiement au lieu d’en créer un doublon (réessai ou relance de migration sans risque). Sans cette référence, chaque appel crée un nouveau paiement."
          }
        }
      },
      "FormSubmit": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "organisation": {
            "type": "string"
          },
          "form": {
            "type": "string",
            "description": "Identifiant du formulaire"
          },
          "state": {
            "type": "string"
          },
          "data": {
            "type": "object"
          },
          "total": {
            "type": "number",
            "description": "Montant total attendu pour l’inscription, en unités majeures de la devise."
          },
          "devise": {
            "type": "string",
            "description": "Code de devise."
          },
          "paye": {
            "type": "number",
            "readOnly": true,
            "description": "Montant réellement payé (somme des paiements COMPLETED), en unités majeures."
          },
          "reste": {
            "type": "number",
            "readOnly": true,
            "description": "Solde restant (max(0, total - paye)), en unités majeures."
          },
          "paiements": {
            "type": "array",
            "readOnly": true,
            "description": "Paiements COMPLETED de cette soumission (montants en unités majeures). Disponible uniquement sur GET /forms-submit/{id}.",
            "items": {
              "type": "object",
              "properties": {
                "amount": {
                  "type": "number"
                },
                "method": {
                  "type": "string",
                  "nullable": true
                },
                "datetime": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          },
          "datetime": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Abonnement": {
        "type": "object",
        "description": "Un abonnement (don récurrent)",
        "properties": {
          "id": {
            "type": "string"
          },
          "organisation": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "active": {
            "type": "boolean"
          },
          "amount": {
            "type": "integer",
            "description": "Montant en unités mineures (centimes)"
          },
          "devise": {
            "type": "string",
            "description": "Code de devise"
          },
          "contact": {
            "type": "string",
            "description": "Identifiant du contact"
          },
          "datetime": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Promesse": {
        "type": "object",
        "description": "Promesse de don : montant qu’un contact s’est engagé à verser et que les paiements honorent progressivement. Stockée dans dettes_v2.",
        "properties": {
          "cerfa": {
            "type": "boolean",
            "default": true,
            "description": "Choix du reçu fiscal applicable uniquement aux paiements futurs. Les paiements et documents existants conservent leur traitement d’origine."
          },
          "receiptRevision": {
            "type": "integer",
            "readOnly": true
          },
          "id": {
            "type": "string"
          },
          "organisation": {
            "type": "string"
          },
          "contact": {
            "type": "string",
            "description": "Identifiant du contact donateur."
          },
          "contactName": {
            "type": "string",
            "readOnly": true,
            "description": "Nom complet du donateur (calculé à la lecture)."
          },
          "montant": {
            "type": "number",
            "description": "Montant de la promesse en unités majeures de la devise (par ex. 50 = 50 €), PAS en centimes — contrairement à Paiement.amount."
          },
          "devise": {
            "type": "string",
            "description": "Code de devise (en minuscules, par ex. \"eur\")."
          },
          "assoc": {
            "type": "string",
            "description": "Identifiant de l’association à laquelle la promesse est rattachée (\"MAIN\" par défaut)."
          },
          "name": {
            "type": "string",
            "description": "Libellé libre de la promesse."
          },
          "type": {
            "type": "string",
            "description": "Catégorie/type en texte libre."
          },
          "occasion": {
            "type": "string",
            "description": "Campagne/occasion de rattachement (texte libre)."
          },
          "typeId": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant du livret OU de la campagne auquel la promesse est rattachée (sélecteur admin « Livret »). Pour une campagne, la promesse est comptabilisée dans son total ; pour un livret, dans son budget."
          },
          "active": {
            "type": "boolean"
          },
          "payed": {
            "type": "number",
            "readOnly": true,
            "description": "Montant déjà payé (unités majeures). Calculé à partir des paiements associés — jamais enregistré."
          },
          "reste": {
            "type": "number",
            "readOnly": true,
            "description": "Montant restant à payer (unités majeures). Calculé — jamais enregistré."
          },
          "hasActiveAbonnement": {
            "type": "boolean",
            "readOnly": true,
            "description": "Indique si un abonnement actif honore cette promesse."
          },
          "status": {
            "type": "string",
            "readOnly": true,
            "enum": [
              "OPEN",
              "PARTIAL",
              "FULFILLED",
              "COVERED",
              "CANCELED"
            ],
            "description": "Cycle de vie calculé : OPEN (aucun paiement), PARTIAL (partiel), FULFILLED (reste<=0), COVERED (payée par un abonnement actif), CANCELED (annulée)."
          },
          "datetime": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "editDatetime": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          }
        }
      },
      "PromesseCreate": {
        "type": "object",
        "required": [
          "contactId",
          "montant"
        ],
        "properties": {
          "cerfa": {
            "type": "boolean",
            "default": true,
            "description": "Choix du reçu fiscal applicable uniquement aux paiements futurs. Les paiements et documents existants conservent leur traitement d’origine."
          },
          "contactId": {
            "type": "string",
            "description": "Identifiant du contact donateur (doit appartenir à l’organisation)."
          },
          "montant": {
            "type": "number",
            "description": "Montant de la promesse en unités majeures de la devise (par ex. 50 = 50 €), PAS en centimes. Doit être > 0."
          },
          "name": {
            "type": "string",
            "description": "Libellé libre de la promesse."
          },
          "occasion": {
            "type": "string",
            "description": "Campagne/occasion de rattachement (texte libre)."
          },
          "type": {
            "type": "string",
            "description": "Catégorie/type en texte libre."
          },
          "assoc": {
            "type": "string",
            "description": "Association à laquelle la promesse est rattachée (\"MAIN\" par défaut). FIXÉE à la création — elle détermine la devise et le reçu, et NE PEUT PLUS être modifiée. Consultez GET /associations pour la liste des associations disponibles."
          },
          "typeId": {
            "type": "string",
            "description": "Identifiant facultatif du livret OU de la campagne auxquels rattacher la promesse (sélecteur admin « Livret »). Si c’est une campagne, la promesse contribue à son total ; si c’est un livret, à son budget."
          }
        }
      },
      "PromesseUpdate": {
        "type": "object",
        "description": "N’importe quel sous-ensemble de ces champs. `assoc` et `devise` ne sont PAS modifiables (fixés à la création). Les champs calculés (reste/payed/status) ne sont jamais acceptés.",
        "properties": {
          "expectedReceiptRevision": {
            "type": "integer",
            "minimum": 0,
            "description": "Révision du reçu renvoyée lors de la dernière lecture ; permet de refuser une modification fiscale devenue obsolète."
          },
          "cerfa": {
            "type": "boolean",
            "default": true,
            "description": "Choix du reçu fiscal applicable uniquement aux paiements futurs. Les paiements et documents existants conservent leur traitement d’origine."
          },
          "contactId": {
            "type": "string"
          },
          "montant": {
            "type": "number",
            "description": "Unités majeures de la devise, > 0."
          },
          "name": {
            "type": "string"
          },
          "occasion": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "typeId": {
            "type": "string",
            "description": "Rattacher à un autre livret/une autre campagne (ou null pour détacher)."
          }
        }
      },
      "PromessePaymentLink": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "url": {
            "type": "string",
            "description": "URL de la page de paiement hébergée permettant d’honorer la promesse."
          },
          "reste": {
            "type": "number",
            "description": "Montant restant (unités majeures)."
          },
          "devise": {
            "type": "string"
          }
        }
      },
      "Association": {
        "type": "object",
        "description": "Association juridique (« association »/cerfa) de l’organisation — détermine la devise et le reçu d’un don. Transmettez son `id` comme `assoc` lors de la création d’une promesse/d’un paiement.",
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifiant de l’association à utiliser comme `assoc` (\"MAIN\" pour l’association principale de l’organisation)."
          },
          "label": {
            "type": "string",
            "description": "Nom d’affichage."
          },
          "devise": {
            "type": "string",
            "description": "Code de devise de cette association (en minuscules)."
          }
        }
      },
      "FormProduct": {
        "type": "object",
        "description": "Ligne de produit d’un formulaire COMPLEX (article acheté).",
        "properties": {
          "id": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "montant": {
            "type": "number",
            "description": "Montant unitaire en unités majeures (par ex. euros)."
          },
          "cerfa": {
            "type": "boolean"
          },
          "simple_stock": {
            "type": "integer",
            "nullable": true
          },
          "activeReducedPrice": {
            "type": "boolean"
          },
          "reducedPercent": {
            "type": "number",
            "nullable": true
          },
          "reducedExpireAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "position": {
            "type": "integer"
          }
        }
      },
      "FormDefinition": {
        "type": "object",
        "description": "Définition publique d’un formulaire (produits, calendriers, HTML transpilé).",
        "properties": {
          "id": {
            "type": "string"
          },
          "organisation": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "SIMPLE",
              "COMPLEX"
            ]
          },
          "title": {
            "type": "string"
          },
          "active": {
            "type": "boolean"
          },
          "withPaiement": {
            "type": "boolean"
          },
          "autoValid": {
            "type": "boolean"
          },
          "requirePaiementValidation": {
            "type": "boolean"
          },
          "content": {
            "type": "string",
            "description": "HTML transpilé lorsque type=SIMPLE."
          },
          "afficheUrl": {
            "type": "string",
            "description": "URL absolue de l’affiche/de l’image de couverture affichée en haut du formulaire (présente si définie)."
          },
          "aiContentBlockId": {
            "type": "string",
            "description": "Identifiant du bloc de contenu IA affiché sous forme de bannière enrichie en haut du formulaire (présent s’il est défini)."
          },
          "products": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FormProduct"
            }
          },
          "calendars": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "expired": {
            "type": "boolean",
            "description": "True si la session PE associée n’est plus active."
          }
        }
      },
      "FormAdditionalField": {
        "type": "object",
        "description": "Champ dynamique ajouté à un formulaire (ou à un produit). Deux portées : les champs GLOBAL (à la racine du formulaire) apparaissent une fois par soumission ; les champs PRODUCT (dans un produit) se répètent pour chaque unité achetée. Utilisez un champ produit uniquement pour recueillir des informations par unité ; tout ce qui concerne la commande entière doit être un champ global.",
        "required": [
          "type"
        ],
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "TEXT-INPUT",
              "TEXTAREA-INPUT",
              "SELECT-INPUT",
              "CHECKBOX-INPUT",
              "DOCS-INPUT",
              "DATE-INPUT",
              "TITLE",
              "CONTACT-INPUT",
              "FREE-AMOUNT-INPUT"
            ],
            "description": "Type de champ. TEXT-INPUT = texte libre sur une ligne ; TEXTAREA-INPUT = texte libre multiligne (avec `height` facultatif en px) ; SELECT-INPUT = liste déroulante (nécessite `values`) ; CHECKBOX-INPUT = oui/non ; DOCS-INPUT = téléversement de fichier (nécessite `doctype`) ; DATE-INPUT = sélecteur de date/heure (`picker`/`dateFilter`/`range`/`defaultNow` facultatifs, date simple par défaut) ; TITLE = séparateur visuel (aucune donnée ; utilise `__title_tag`+`__text`) ; CONTACT-INPUT = contact CRM secondaire (nom+email+téléphone) ; FREE-AMOUNT-INPUT = montant choisi par le donateur (GLOBAL uniquement, exige withPaiement=true, jamais dans un produit)."
          },
          "required": {
            "type": "boolean",
            "description": "Indique si le champ est obligatoire."
          },
          "__label": {
            "type": "string",
            "description": "Libellé visible du champ."
          },
          "values": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Options de SELECT-INPUT (obligatoires pour ce type)."
          },
          "doctype": {
            "type": "string",
            "enum": [
              "IMG",
              "PDF",
              "ZIP"
            ],
            "description": "Type de fichier autorisé pour DOCS-INPUT."
          },
          "height": {
            "type": "integer",
            "description": "TEXTAREA-INPUT uniquement : hauteur fixe de la zone de texte, en pixels (facultative)."
          },
          "picker": {
            "type": "string",
            "enum": [
              "Date & Heure",
              "Uniquement les Années",
              "Uniquement les Mois",
              "Uniquement l'heure"
            ],
            "description": "DATE-INPUT uniquement : granularité. Omettre pour une date simple (JJ/MM/AAAA). \"Date & Heure\" = date et heure ; \"Uniquement les Années\" = année ; \"Uniquement les Mois\" = mois ; \"Uniquement l'heure\" = heure."
          },
          "dateFilter": {
            "type": "string",
            "enum": [
              "Antérieur à aujourd'hui",
              "Ultérieur à aujourd'hui",
              "Aujourd'hui & antérieur à aujourd'hui",
              "Aujourd'hui & ultérieur à aujourd'hui"
            ],
            "description": "DATE-INPUT uniquement : limiter les dates sélectionnables par rapport à aujourd’hui (facultatif)."
          },
          "range": {
            "type": "boolean",
            "description": "DATE-INPUT uniquement : choisir une plage début→fin plutôt qu’une seule valeur (facultatif)."
          },
          "defaultNow": {
            "type": "boolean",
            "description": "DATE-INPUT uniquement : préremplir avec la date/heure actuelle (facultatif)."
          },
          "__title_tag": {
            "type": "string",
            "enum": [
              "h1",
              "h2",
              "h3",
              "h4",
              "h5"
            ],
            "description": "Niveau de titre pour TITLE."
          },
          "__text": {
            "type": "string",
            "description": "Texte du titre pour TITLE."
          }
        }
      },
      "FormProductInput": {
        "type": "object",
        "description": "Ligne de produit d’un formulaire (article, billet ou option pouvant être acheté). LES VARIATIONS DE PRIX SE FONT UNIQUEMENT AU MOYEN DE PRODUITS DISTINCTS — jamais avec des options tarifaires sur un seul produit.",
        "required": [
          "label",
          "title",
          "montant"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifiant du produit (omettre à la création ; lors de la modification, correspondance par identifiant ou libellé)."
          },
          "label": {
            "type": "string",
            "description": "Libellé interne unique dans le formulaire."
          },
          "title": {
            "type": "string",
            "description": "Titre public affiché à l’acheteur."
          },
          "description": {
            "type": "string",
            "description": "Description interne (visible par l’admin uniquement)."
          },
          "montant": {
            "type": "number",
            "description": "Prix unitaire en unités MAJEURES (par ex. euros). 0 = gratuit. Interprété par mois lorsque paiementType=MONTHLY."
          },
          "cerfa": {
            "type": "boolean",
            "description": "Indique si ce produit ouvre droit à un reçu fiscal."
          },
          "active": {
            "type": "boolean",
            "description": "Indique si le produit est actif (true par défaut)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Catégories CRM appliquées au contact UNIQUEMENT lorsque ce produit est sélectionné."
          },
          "simple_stock": {
            "type": "integer",
            "description": "Limite de stock pour ce produit. Ignorée lorsque globalStock est défini."
          },
          "additionalFields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FormAdditionalField"
            },
            "description": "Champs par produit, répétés pour chaque quantité achetée."
          }
        }
      },
      "FormInput": {
        "type": "object",
        "description": "Objet métier de l’éditeur pour une DÉFINITION de formulaire — structure à envoyer pour créer ou modifier un formulaire, et structure renvoyée par GET /forms/{id}/edit. Un formulaire est un moteur transactionnel flexible : une soumission peut correspondre à une commande de billets, un achat de plusieurs produits, une inscription familiale, un don, etc. Distinguez le PAYEUR (qui soumet) des BÉNÉFICIAIRES (renseignés dans les champs supplémentaires du produit). Dans un PATCH partiel, omettez `products`/`additionalFields` pour les laisser tels quels ; envoyez-les pour remplacer l’ensemble.",
        "required": [
          "title"
        ],
        "properties": {
          "title": {
            "type": "string",
            "description": "Titre public du formulaire (obligatoire)."
          },
          "url": {
            "type": "string",
            "description": "Slug public (minuscules, sans accents, espaces remplacés par \"-\"). Facultatif."
          },
          "description": {
            "type": "string",
            "description": "Description interne (visible par l’admin uniquement)."
          },
          "afficheUrl": {
            "type": "string",
            "description": "URL de l’affiche/de l’image de couverture ou nom du fichier hébergé, affiché en haut du formulaire. Ajoute les métadonnées de partage WhatsApp. Envoyez \"\" pour la supprimer. Peut coexister avec aiContentBlockId (les deux peuvent être définis)."
          },
          "aiContentBlockId": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant d’un bloc de contenu IA (ai_content_blocks), affiché sous forme de bannière HTML enrichie tout en haut du formulaire, au-dessus des champs d’identité. Facultatif — omettre pour ne pas modifier ; envoyer \"\"/null pour le supprimer. Indépendant de afficheUrl (l’image d’affiche) : un formulaire peut afficher les deux."
          },
          "autoValid": {
            "type": "boolean",
            "description": "true = soumissions validées automatiquement ; false = validation manuelle."
          },
          "withPaiement": {
            "type": "boolean",
            "description": "Activer le paiement en ligne. Si false, tous les champs de paiement ci-dessous sont ignorés."
          },
          "paiementType": {
            "type": "string",
            "enum": [
              "PAIEMENT",
              "ABONNEMENT",
              "MONTHLY"
            ],
            "description": "Modèle de facturation : PAIEMENT = paiement ponctuel ; ABONNEMENT = versements limités ; MONTHLY = paiement mensuel récurrent. Nécessite withPaiement=true."
          },
          "onePaiement": {
            "type": "boolean",
            "description": "Imposer un paiement unique (sans acompte). Uniquement avec paiementType=PAIEMENT."
          },
          "deposit": {
            "type": "number",
            "description": "Montant fixe de l’acompte. paiementType=PAIEMENT et onePaiement=false."
          },
          "depositPercent": {
            "type": "number",
            "description": "Acompte en pourcentage (0-100). Même dépendance que `deposit`."
          },
          "abonnementMaxMonth": {
            "type": "integer",
            "description": "Nombre maximal de versements (≥2). paiementType=ABONNEMENT."
          },
          "aboMonthInfinite": {
            "type": "boolean",
            "description": "Abonnement sans date de fin. paiementType=MONTHLY."
          },
          "aboMonthMin": {
            "type": "integer",
            "description": "Nombre minimal de mois d’abonnement (≥1). MONTHLY + aboMonthInfinite=false."
          },
          "aboMonthMax": {
            "type": "integer",
            "description": "Nombre maximal de mois d’abonnement (≥ aboMonthMin). MONTHLY + aboMonthInfinite=false."
          },
          "paiementMethods": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Autres moyens de paiement manuels possibles, par ex. [\"CHEQUE\",\"VIREMENT\",\"ESPECES\"]."
          },
          "requirePaiementValidation": {
            "type": "boolean",
            "description": "Validation conditionnée au paiement en ligne. Nécessite withPaiement=true."
          },
          "autoValidOtherPaiementMethod": {
            "type": "boolean",
            "description": "Valider automatiquement les paiements par un autre moyen. Nécessite requirePaiementValidation=true."
          },
          "allowZeroAmount": {
            "type": "boolean",
            "description": "Autoriser une soumission dont le total est égal à 0."
          },
          "identity": {
            "type": "string",
            "enum": [
              "SIMPLE"
            ],
            "description": "Niveau d’identification du contact. SIMPLE = nom complet + email + téléphone."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Catégories CRM appliquées automatiquement à chaque contact ayant soumis le formulaire."
          },
          "globalStock": {
            "type": "integer",
            "nullable": true,
            "description": "Stock partagé qui remplace les stocks définis par produit."
          },
          "allowNoProduct": {
            "type": "boolean",
            "description": "Autoriser l’envoi d’une soumission sans sélectionner de produit."
          },
          "products": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FormProductInput"
            },
            "description": "Articles pouvant être achetés. Utilisez des produits distincts pour des prix différents."
          },
          "additionalFields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FormAdditionalField"
            },
            "description": "Champs personnalisés globaux (une fois par soumission)."
          }
        }
      },
      "Caisse": {
        "type": "object",
        "description": "Une cagnotte, telle que renvoyée à la lecture, enrichie des totaux collectés.",
        "properties": {
          "id": {
            "type": "string"
          },
          "organisation": {
            "type": "string"
          },
          "name": {
            "type": "string",
            "description": "Nom public de la cagnotte."
          },
          "label": {
            "type": "string",
            "description": "Libellé interne."
          },
          "objectif": {
            "type": "number",
            "description": "Objectif de collecte en unités MAJEURES (par ex. euros)."
          },
          "withObjectif": {
            "type": "boolean",
            "description": "Indique si une barre de progression vers l’objectif est affichée."
          },
          "marge": {
            "type": "number",
            "description": "Frais/marge appliqués."
          },
          "bgimage": {
            "type": "string",
            "nullable": true,
            "description": "Image d’arrière-plan (nom de fichier hébergé)."
          },
          "assoc": {
            "type": "string",
            "description": "Identifiant de l’association juridique (\"MAIN\" ou UUID)."
          },
          "typeId": {
            "type": "string",
            "description": "Lien vers le livret/PE ; identique à l’identifiant de la cagnotte lorsqu’elle est autonome."
          },
          "active": {
            "type": "boolean"
          },
          "paused": {
            "type": "boolean"
          },
          "archived": {
            "type": "boolean"
          },
          "cerfa": {
            "type": "boolean",
            "description": "Indique si les dons versés dans cette cagnotte donnent lieu à un reçu fiscal (true par défaut)."
          },
          "url": {
            "type": "string",
            "description": "Slug personnalisé de l’URL publique de la page de la cagnotte."
          },
          "hidden": {
            "type": "boolean",
            "description": "Masquer la cagnotte des listes publiques."
          },
          "presetButtons": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Montants de don prédéfinis proposés aux donateurs."
          },
          "imagesCaroussel": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Carrousel d’images (noms de fichiers hébergés)."
          },
          "textContent": {
            "type": "string",
            "description": "Contenu enrichi de la page."
          },
          "youtubeId": {
            "type": "string",
            "description": "Identifiant de la vidéo YouTube affichée sur la page."
          },
          "aiContentBlockId": {
            "type": "string",
            "description": "Identifiant du bloc de contenu IA associé."
          },
          "pe": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant de la session Parcours d'Événement à laquelle cette cagnotte est rattachée."
          },
          "payed": {
            "type": "number",
            "readOnly": true,
            "description": "Total collecté à ce jour (calculé)."
          },
          "reste": {
            "type": "number",
            "readOnly": true,
            "description": "Montant restant pour atteindre l’objectif (calculé)."
          },
          "datetime": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "CaisseInput": {
        "type": "object",
        "description": "Données pour créer ou modifier une cagnotte. Avec un PATCH partiel, seuls les champs fournis sont modifiés.",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Nom public de la cagnotte (obligatoire à la création)."
          },
          "label": {
            "type": "string",
            "description": "Libellé interne (nom par défaut)."
          },
          "objectif": {
            "type": "number",
            "description": "Objectif de collecte en unités MAJEURES (par ex. euros)."
          },
          "withObjectif": {
            "type": "boolean",
            "description": "Afficher une barre de progression vers l’objectif."
          },
          "marge": {
            "type": "number",
            "description": "Frais/marge appliqués (0 par défaut)."
          },
          "bgimage": {
            "type": "string",
            "description": "Image d’arrière-plan : URL http(s) (réhébergée côté serveur) ou nom de fichier déjà hébergé."
          },
          "assoc": {
            "type": "string",
            "description": "Identifiant de l’association juridique (\"MAIN\" par défaut)."
          },
          "typeId": {
            "type": "string",
            "description": "Identifiant du livret/PE auquel rattacher la cagnotte, ou \"AUTO\" pour une cagnotte autonome (rattachée à elle-même)."
          },
          "cerfa": {
            "type": "boolean",
            "description": "Indique si les dons versés dans cette cagnotte donnent lieu à un reçu fiscal (true par défaut)."
          },
          "url": {
            "type": "string",
            "description": "Slug personnalisé de l’URL publique de la page de la cagnotte."
          },
          "hidden": {
            "type": "boolean",
            "description": "Masquer la cagnotte des listes publiques."
          },
          "presetButtons": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Montants de don prédéfinis proposés aux donateurs."
          },
          "imagesCaroussel": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Carrousel d’images : chaque entrée est une URL http(s) (réhébergée) ou un nom de fichier déjà hébergé."
          },
          "textContent": {
            "type": "string",
            "description": "Contenu enrichi de la page."
          },
          "youtubeId": {
            "type": "string",
            "description": "Identifiant de la vidéo YouTube affichée sur la page."
          },
          "aiContentBlockId": {
            "type": "string",
            "description": "Identifiant du bloc de contenu IA associé."
          },
          "pe": {
            "type": "string",
            "description": "Identifiant de session Parcours d'Événement auquel rattacher cette cagnotte."
          }
        }
      },
      "Page": {
        "type": "object",
        "description": "Page personnalisée du site web. Identifiée par `route` (segments du slug) — `url` est la route concaténée. Le contenu est soit généré par IA (`html`+`i18n`+`mainLang`), soit issu de l’ancien éditeur visuel (`content`) ; `aiEditable` indique si le contenu peut être modifié via cette API.",
        "properties": {
          "id": {
            "type": "string"
          },
          "organisation": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "MAIN_PAGE",
              "CUSTOM_PAGE"
            ],
            "description": "MAIN_PAGE = ancienne page d’accueil (URL verrouillée ; n’est plus créée automatiquement) ; CUSTOM_PAGE = page standard."
          },
          "editorType": {
            "type": "string",
            "enum": [
              "AI",
              "EDITOR"
            ],
            "description": "Éditeur propriétaire du contenu : \"AI\" (html + data-i18n, seul type modifiable via cette API) ou \"EDITOR\" (ancien éditeur visuel). Les pages créées via cette API sont toujours de type \"AI\"."
          },
          "label": {
            "type": "string",
            "description": "Libellé interne."
          },
          "title": {
            "type": "string",
            "description": "Titre public de la page."
          },
          "description": {
            "type": "string",
            "description": "Description de la page ; utilisée comme valeur SEO de repli automatique si aucune description SEO de page/site n’est définie."
          },
          "metaTitle": {
            "type": "string",
            "nullable": true,
            "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "metaDescription": {
            "type": "string",
            "nullable": true,
            "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "metaImage": {
            "type": "string",
            "nullable": true,
            "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "en": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "he": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "it": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "de": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "es": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "properties": {
              "metaTitle": {
                "type": "string",
                "nullable": true,
                "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaDescription": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              },
              "metaImage": {
                "type": "string",
                "nullable": true,
                "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
              }
            },
            "additionalProperties": true,
            "description": "Champs de page traduits, y compris les personnalisations SEO. D’autres contenus de page traduits peuvent également être présents."
          },
          "route": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Chemin d’URL sous forme de segments de slug (par ex. [\"infos\",\"horaires\"])."
          },
          "url": {
            "type": "string",
            "readOnly": true,
            "description": "Route concaténée (\"infos/horaires\"). Champ pratique en lecture seule."
          },
          "active": {
            "type": "boolean"
          },
          "html": {
            "type": "string",
            "description": "HTML du contenu IA (avec attributs data-i18n). Présent sur les pages IA."
          },
          "mainLang": {
            "type": "string",
            "nullable": true,
            "description": "Langue par défaut du contenu HTML."
          },
          "i18n": {
            "type": "object",
            "description": "Traductions : { lang: { i18nKey: value } } pour les clés data-i18n du HTML.",
            "additionalProperties": true
          },
          "aiEditable": {
            "type": "boolean",
            "readOnly": true,
            "description": "Indique si le contenu de la page peut être modifié via PUT /pages/{id}/content (false pour les pages de l’ancien éditeur visuel)."
          },
          "datetime": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "PageSeoOverlay": {
        "type": "object",
        "nullable": true,
        "additionalProperties": false,
        "description": "Traduction SEO partielle pour une autre langue activée. La langue par défaut de l’organisation reste à la racine. Seuls les champs fournis sont modifiés. Null ou un objet vide efface uniquement le SEO de cette langue et préserve les autres traductions du contenu de la page ; l’effacement d’un SEO obsolète reste autorisé après désactivation d’une langue. Les champs acceptent null/chaînes vides pour rétablir la valeur de repli. À distinguer des dictionnaires i18n du HTML.",
        "properties": {
          "metaTitle": {
            "type": "string",
            "nullable": true,
            "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "metaDescription": {
            "type": "string",
            "nullable": true,
            "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "metaImage": {
            "type": "string",
            "nullable": true,
            "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          }
        }
      },
      "PageInput": {
        "type": "object",
        "description": "Données pour créer ou modifier les métadonnées et le SEO d’une page (metaTitle/metaDescription/metaImage). Une page créée ici est une page IA (son contenu peut ensuite être défini via PUT /pages/{id}/content). Avec un PATCH partiel, seuls les champs fournis sont modifiés, y compris dans une surcharge linguistique. La modification du SEO fonctionne pour les pages IA et celles de l’ancien éditeur. La langue par défaut reste à la racine ; les autres langues activées utilisent des surcharges. Les champs SEO remplacent chacun indépendamment les valeurs du site ; null/champ vide rétablit la valeur de repli. Ce mécanisme est distinct des traductions HTML data-i18n.",
        "required": [
          "title",
          "url"
        ],
        "properties": {
          "label": {
            "type": "string",
            "description": "Libellé interne."
          },
          "title": {
            "type": "string",
            "description": "Titre public de la page (obligatoire à la création)."
          },
          "description": {
            "type": "string",
            "description": "Description de la page ; valeur SEO de repli automatique lorsqu’aucune description SEO de page/site n’est définie."
          },
          "metaTitle": {
            "type": "string",
            "nullable": true,
            "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "metaDescription": {
            "type": "string",
            "nullable": true,
            "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "metaImage": {
            "type": "string",
            "nullable": true,
            "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "fr": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "en": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "he": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "it": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "ru": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "pt": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "de": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "es": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "gr": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "ro": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "url": {
            "type": "string",
            "description": "URL de la page, par ex. \"infos/horaires\" (obligatoire à la création). Normalisée côté serveur en segments de slug ; doit être unique et ne pas entrer en conflit avec une page intégrée. L’URL de la page d’accueil ne peut pas être modifiée."
          },
          "active": {
            "type": "boolean",
            "description": "Indique si la page est publiée (true par défaut)."
          }
        }
      },
      "PageContentInput": {
        "type": "object",
        "description": "Contenu HTML d’une page IA. Envoyez du HTML BRUT — vous n’avez PAS à gérer vous-même les clés de traduction. Le serveur traite le HTML et ajoute un attribut `data-i18n=\"<key>\"` sur chaque nœud de texte traduisible qui n’en possède pas (et `data-i18n-alt`/`-title`/`-placeholder`/`-aria-label` pour ces attributs), en générant des clés telles que `auto_1`. Le texte de `mainLang` devient le dictionnaire de référence ; les traductions existantes dans les autres langues sont conservées et les clés obsolètes supprimées. Pour traduire, relisez la page afin d’obtenir les clés, puis appelez POST /pages/{id}/translations avec `{lang, dict:{key:value}}`. Refusé avec PAGE_CONTENT_NOT_EDITABLE pour les pages de l’ancien éditeur.",
        "required": [
          "html"
        ],
        "properties": {
          "html": {
            "type": "string",
            "description": "HTML de la page (fragment ou document complet). Les clés data-i18n sont ajoutées automatiquement."
          },
          "mainLang": {
            "type": "string",
            "description": "Langue utilisée pour rédiger le HTML (par ex. \"fr\"). Par défaut, mainLang actuel de la page ou langue par défaut de l’organisation."
          },
          "assets": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Noms de fichiers facultatifs des ressources référencées dans le HTML."
          }
        }
      },
      "PageTranslationsInput": {
        "type": "object",
        "description": "Traductions des clés data-i18n existantes d’une page IA pour une langue. Ne modifie pas le HTML. Lisez la page (son `i18n` et les clés `data-i18n` de `html`) pour découvrir les clés.",
        "required": [
          "lang",
          "dict"
        ],
        "properties": {
          "lang": {
            "type": "string",
            "description": "Code de la langue cible (par ex. \"en\", \"he\")."
          },
          "dict": {
            "type": "object",
            "description": "{ i18nKey: translatedValue } (valeur traduite).",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "ContentBlock": {
        "type": "object",
        "description": "Bloc de contenu IA réutilisable : fragment HTML autonome affiché sur le site public partout où son `id` est référencé (par ex. sur la page d’accueil touristique via `homepage.aiContentBlockId` dans la configuration Travel, ou dans l’introduction d’un groupe d’événements à sessions multiples). Contient le HTML avec des clés `data-i18n` ainsi que le dictionnaire `i18n` de leurs traductions.",
        "properties": {
          "id": {
            "type": "string"
          },
          "organisation": {
            "type": "string"
          },
          "html": {
            "type": "string",
            "description": "Fragment HTML du bloc (avec attributs data-i18n)."
          },
          "mainLang": {
            "type": "string",
            "nullable": true,
            "description": "Langue par défaut utilisée pour rédiger le HTML."
          },
          "i18n": {
            "type": "object",
            "description": "Traductions : { lang: { i18nKey: value } } pour les clés data-i18n du HTML.",
            "additionalProperties": true
          },
          "assets": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Noms de fichiers des ressources référencées dans le HTML."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "datetime": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          }
        }
      },
      "ContentBlockContentInput": {
        "type": "object",
        "description": "Contenu HTML d’un bloc IA. Envoyez du HTML BRUT — vous n’avez PAS à gérer vous-même les clés de traduction : le serveur ajoute un attribut `data-i18n=\"<key>\"` sur chaque nœud de texte traduisible qui n’en possède pas (et `data-i18n-alt`/`-title`/`-placeholder`/`-aria-label` pour ces attributs), en générant des clés telles que `auto_1`. Le texte de `mainLang` devient le dictionnaire de référence ; les traductions existantes des autres langues sont conservées et les clés obsolètes supprimées (conservez donc les clés data-i18n existantes lorsque vous modifiez de nouveau le contenu). Le bloc est affiché partout où son identifiant est référencé (par ex. sur la page d’accueil touristique).\n\nRÈGLES DE RÉDACTION OBLIGATOIRES pour le HTML (identiques à celles de l’éditeur IA intégré, puisqu’aucun éditeur ne peut les imposer ici) :\n• Produisez uniquement un FRAGMENT — aucun <!DOCTYPE>, <html>, <head> ni <body> ; commencez directement par <section>/<div>/<article>.\n• Placez tout le contenu dans un conteneur centré : max-width:1200px ; margin:0 auto ; padding latéral de 24px sur ordinateur / 16px sur mobile.\n• Préfixez TOUTES les classes CSS par `.aicb-` (par ex. .aicb-hero, .aicb-card) pour éviter les conflits avec la page hôte.\n• N’utilisez JAMAIS les unités de hauteur de fenêtre vh/vmin/vmax (le bloc est affiché dans une iframe à hauteur automatique → boucle infinie) ; utilisez px/rem ou min-height:600px pour les sections de bannière principale. vw (largeur) est autorisé.\n• Placez <style> AU DÉBUT du fragment et tout <script> À LA FIN. CSS natif uniquement (flexbox/grid/variables/@keyframes).\n• Polices : Google Fonts via @import dans <style> (Inter, Plus Jakarta Sans, DM Sans). Icônes : Lucide via CDN (<script src=\"https://unpkg.com/lucide@latest\"></script> + lucide.createIcons(), <i data-lucide=\"...\">).\n• Il s’agit d’un site communautaire JUIF : n’introduisez JAMAIS de symbole/icone/emoji d’une autre religion (Lucide `church`/`cross`…, emojis ✝️⛪☦️☪️🕌🛕☸️🔯). Les symboles juifs (✡️ 🕎) et les icônes/emojis neutres conviennent.\n• Évitez le texte blanc sur une carte colorée (lisibilité).",
        "required": [
          "html"
        ],
        "properties": {
          "html": {
            "type": "string",
            "description": "Fragment HTML du bloc. Les clés data-i18n sont ajoutées automatiquement. Respectez les règles de rédaction ci-dessus."
          },
          "mainLang": {
            "type": "string",
            "description": "Langue utilisée pour rédiger le HTML (par ex. \"fr\"). Par défaut, mainLang actuel du bloc ou langue par défaut de l’organisation."
          },
          "assets": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Noms de fichiers facultatifs des ressources référencées dans le HTML."
          }
        }
      },
      "ContentBlockTranslationsInput": {
        "type": "object",
        "description": "Traductions des clés data-i18n existantes d’un bloc de contenu pour une langue. Ne modifie pas le HTML. Lisez le bloc (`i18n` et les clés `data-i18n` de `html`) pour découvrir les clés.",
        "required": [
          "lang",
          "dict"
        ],
        "properties": {
          "lang": {
            "type": "string",
            "description": "Code de la langue cible (par ex. \"en\", \"he\")."
          },
          "dict": {
            "type": "object",
            "description": "{ i18nKey: translatedValue } (valeur traduite).",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "EmailTemplate": {
        "type": "object",
        "description": "Modèle HTML d’email réutilisable (collection email_templates). Email HTML complet réutilisable par une organisation — par ex. associé à une campagne comme email de remerciement au donateur (`campagnes.config.donorEmailTemplate`). `design`/`assets` sont les structures internes de l’éditeur (exposées en lecture seule).",
        "properties": {
          "id": {
            "type": "string"
          },
          "organisation": {
            "type": "string"
          },
          "name": {
            "type": "string",
            "description": "Nom d’affichage du modèle."
          },
          "editorType": {
            "type": "string",
            "enum": [
              "EDITOR",
              "AI"
            ],
            "description": "Éditeur utilisé : EDITOR (éditeur visuel, stocke `design`) ou AI (éditeur IA, stocke `assets`)."
          },
          "html": {
            "type": "string",
            "nullable": true,
            "description": "Email HTML complet."
          },
          "design": {
            "type": "object",
            "nullable": true,
            "readOnly": true,
            "description": "Sérialisation de l’éditeur visuel (lecture seule ; modèles EDITOR uniquement).",
            "additionalProperties": true
          },
          "assets": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "readOnly": true,
            "description": "Identifiants de ressources intégrés par l’éditeur IA (lecture seule)."
          },
          "thumbnailUrl": {
            "type": "string",
            "format": "uri",
            "nullable": true,
            "readOnly": true,
            "description": "URL publique de l’aperçu PNG généré automatiquement (au mieux ; null s’il n’a pas été généré)."
          },
          "datetime": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "editDatetime": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          }
        }
      },
      "EmailTemplateCreateInput": {
        "type": "object",
        "description": "Créer un modèle d’email. `html` est facultatif (vous pouvez créer un modèle vide, puis le remplir via PUT /{id}/content). S’il est fourni, respectez les règles de compatibilité des clients de messagerie décrites dans EmailTemplateContentInput.",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Nom d’affichage."
          },
          "editorType": {
            "type": "string",
            "enum": [
              "EDITOR",
              "AI"
            ],
            "default": "AI",
            "description": "AI par défaut."
          },
          "html": {
            "type": "string",
            "description": "Email HTML complet (voir les règles de EmailTemplateContentInput)."
          }
        }
      },
      "EmailTemplateContentInput": {
        "type": "object",
        "description": "Email HTML complet d’un modèle. Contrairement à un bloc de contenu, il s’agit d’un DOCUMENT EMAIL HTML COMPLET (<!DOCTYPE html><html>…</html> attendu). Un aperçu PNG est généré automatiquement au mieux (peut être null).\n\nRÈGLES DE COMPATIBILITÉ CLIENTS EMAIL que le HTML DOIT respecter (identiques à celles de l’éditeur IA d’email intégré, puisqu’aucun éditeur ne peut les imposer ici) :\n• Mise en page avec <table>/<tr>/<td> UNIQUEMENT (pas de flexbox/grid — Outlook les ignore).\n• Styles INLINE uniquement — pas de bloc <style> externe, pas de classes CSS (Outlook les supprime).\n• Largeur maximale de 600px, centrée, arrière-plan de page neutre (#f4f4f4).\n• Polices : UNIQUEMENT Arial, Helvetica, sans-serif (les polices web ne sont pas prises en charge).\n• Images avec attributs HTML width/height EXPLICITES (pas seulement en CSS).\n• Pas de JavaScript ni de formulaires complexes ; couleurs de liens en ligne, pas de :hover.\n• Structure OBLIGATOIRE : en-tête (bande colorée avec logo/nom de l’organisation) + corps (zone blanche) + pied de page (mentions légales, lien de désinscription {{mailing_unsubscribe}} — OBLIGATOIRE — et coordonnées).\n• Variables disponibles pour l’interpolation : {{firstname}}, {{lastname}}, {{hebrewname}}, {{mailing_unsubscribe}} (alias historiques {{prenom}}, {{nom}}, {{prenomHE}} toujours pris en charge ; variables de l’organisation comme {{org.name}} également disponibles).\n• Cet email est destiné à une communauté JUIVE : n’introduisez JAMAIS de symbole/emoji d’une autre religion (✝️ ✝ ⛪ ☦️ ☪️ 🕌 🛕 ☸️ 🔯). Les symboles juifs (✡️ 🕎) et les emojis neutres conviennent.",
        "required": [
          "html"
        ],
        "properties": {
          "html": {
            "type": "string",
            "description": "Email HTML complet. Respectez les règles ci-dessus."
          }
        }
      },
      "EmailTemplateRenameInput": {
        "type": "object",
        "description": "Renommer un modèle d’email (métadonnées uniquement ; ne modifie pas le HTML).",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "type": "string"
          }
        }
      },
      "Gallery": {
        "type": "object",
        "description": "Galerie photo (collection `galeries`) — album photo publié par l’organisation sur son site web (pages de thème « Galeries » / « GalerieImages »). Les réponses de liste/détail n’incluent PAS le tableau complet `images[]` (qui peut être volumineux) ; elles exposent `nbImages` et l’image de couverture. Récupérez les images via GET /galleries/{id}/images.",
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true,
            "description": "UUID de la galerie généré par le serveur."
          },
          "name": {
            "type": "string",
            "description": "Nom d’affichage de l’album."
          },
          "description": {
            "type": "string",
            "description": "Description facultative affichée sous le titre de l’album."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Catégories en texte libre utilisées pour regrouper/filtrer les albums (par ex. « Fêtes », « Chabbat »)."
          },
          "compte": {
            "type": "string",
            "description": "Livret comptable auquel l’album est rattaché : \"PRINCIPAL\" (général) ou identifiant d’une caisse virtuelle. \"PRINCIPAL\" par défaut."
          },
          "contact": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant facultatif d’un contact CRM auquel l’album est associé."
          },
          "nbImages": {
            "type": "integer",
            "readOnly": true,
            "description": "Nombre d’images dans l’album (calculé)."
          },
          "bgImage": {
            "type": "string",
            "nullable": true,
            "readOnly": true,
            "description": "Image de couverture = nom du fichier hébergé de la première image (\"md5.ext\"), ou null si l’album est vide."
          },
          "bgImageUrl": {
            "type": "string",
            "format": "uri",
            "nullable": true,
            "readOnly": true,
            "description": "URL publique de l’image de couverture (null si l’album est vide)."
          },
          "active": {
            "type": "boolean",
            "readOnly": true,
            "description": "false après suppression logique (masquée du site et des listes)."
          },
          "datetime": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          }
        }
      },
      "GalleryCreateInput": {
        "type": "object",
        "description": "Créer une galerie photo (vide). Ajoutez des images ensuite via POST /galleries/{id}/images.",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Nom d’affichage de l’album."
          },
          "description": {
            "type": "string",
            "description": "Description facultative."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Catégories."
          },
          "compte": {
            "type": "string",
            "default": "PRINCIPAL",
            "description": "Livret comptable : \"PRINCIPAL\" (général) ou identifiant d’une caisse virtuelle."
          },
          "contact": {
            "type": "string",
            "description": "Identifiant facultatif d’un contact CRM à associer."
          }
        }
      },
      "GalleryUpdateInput": {
        "type": "object",
        "description": "Mettre à jour les métadonnées d’une galerie (mise à jour partielle). Seuls les champs envoyés sont modifiés ; les images ne sont jamais modifiées ici (utilisez les opérations dédiées aux images).",
        "properties": {
          "name": {
            "type": "string",
            "description": "Nouveau nom d’affichage (non vide s’il est fourni)."
          },
          "description": {
            "type": "string",
            "description": "Nouvelle description."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Remplace les catégories."
          },
          "compte": {
            "type": "string",
            "description": "Nouveau livret comptable (\"PRINCIPAL\" ou identifiant d’une caisse)."
          },
          "contact": {
            "type": "string",
            "nullable": true,
            "description": "Associer/dissocier un contact CRM (null pour le dissocier)."
          }
        }
      },
      "GalleryAddImagesInput": {
        "type": "object",
        "description": "Ajouter des images à une galerie. DEUX modes de transmission sont acceptés sur POST /galleries/{id}/images :\n• multipart/form-data — envoyez un ou plusieurs champs de fichier image (n’importe quel nom de champ). À privilégier avec un client HTTP (Make/n8n/application). 5 Mo maximum par image, image/* uniquement.\n• application/json — ce schéma : chaque entrée `images` est une URL http(s) (téléchargée puis réhébergée côté serveur) ou un nom de fichier \"md5.ext\" déjà hébergé. C’est le mode utilisé par un agent MCP/IA (il ne peut pas transmettre un flux binaire).\nLes doublons (image déjà présente dans l’album) sont ignorés. Les fichiers réhébergés sont dédoublonnés selon leur contenu.",
        "required": [
          "images"
        ],
        "properties": {
          "images": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "URLs d’images http(s) (réhébergées) ou noms de fichiers \"md5.ext\" déjà hébergés."
          }
        }
      },
      "GalleryRemoveImagesInput": {
        "type": "object",
        "description": "Retirer des images d’une galerie en indiquant leur nom de fichier hébergé. Les fichiers physiques ne sont PAS supprimés (ils peuvent être utilisés ailleurs) — seule leur référence dans cet album est supprimée.",
        "required": [
          "images"
        ],
        "properties": {
          "images": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Noms de fichiers hébergés (\"md5.ext\") actuellement présents dans l’album, à détacher."
          }
        }
      },
      "GalleryReorderImagesInput": {
        "type": "object",
        "description": "Définir l’ordre d’affichage des images d’une galerie. `order` doit être une permutation des noms de fichiers actuels de l’album ; toute image omise est ajoutée à la fin dans son ordre actuel (aucune image n’est perdue), et les noms inconnus sont ignorés. La première image devient la couverture de l’album.",
        "required": [
          "order"
        ],
        "properties": {
          "order": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Noms de fichiers hébergés dans l’ordre souhaité."
          }
        }
      },
      "CampaignMedia": {
        "type": "object",
        "description": "Élément de média de campagne. `doc` est une URL http(s) (réhébergée à l’écriture) ou un nom de fichier déjà hébergé (par ex. renvoyé par POST /uploads).",
        "properties": {
          "name": {
            "type": "string",
            "description": "Libellé d’affichage."
          },
          "doc": {
            "type": "string",
            "description": "URL http(s) (réhébergée) ou nom de fichier hébergé."
          }
        }
      },
      "CampaignLink": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "Campaign": {
        "type": "object",
        "description": "Campagne de messages (collection messages) : envoi groupé WhatsApp/SMS/Email. Cycle de vie INIT (brouillon) → VALIDATE (envoyée) → FINISHED (terminée). `targets`/`percentSuccess`/`percentError` sont calculés à partir des livraisons.",
        "properties": {
          "crmTarget": {
            "type": "object",
            "readOnly": true,
            "description": "Ciblage versionné des listes/catégories de contacts. Union par défaut ; les exclusions sont prioritaires sur les inclusions. Relecture du back-office requise avant toute modification, prévisualisation ou envoi."
          },
          "id": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "WHATSAPP",
              "SMS",
              "EMAIL",
              "WHATSAPP_OU_SMS",
              "WHATSAPP_OU_EMAIL",
              "WHATSAPP_OU_SMS_OU_EMAIL",
              "SMS_OU_EMAIL"
            ],
            "description": "Canal ou cascade de remplacement."
          },
          "state": {
            "type": "string",
            "enum": [
              "INIT",
              "VALIDATE",
              "FINISHED"
            ],
            "readOnly": true,
            "description": "INIT = brouillon (modifiable) ; VALIDATE = envoi en cours/envoyée ; FINISHED = terminée."
          },
          "subject": {
            "type": "string",
            "description": "Objet de l’email (canaux EMAIL)."
          },
          "message": {
            "type": "string",
            "description": "Corps du message (texte, avec interpolation {{firstname}}/{{lastname}}/{{hebrewname}} ; les alias historiques {{prenom}}/{{nom}}/{{prenomHE}} restent pris en charge)."
          },
          "emailContent": {
            "type": "string",
            "description": "Corps complet de l’email HTML (alternative à emailTemplate)."
          },
          "emailTemplate": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant d’un modèle d’email (son HTML est chargé dans emailContent au moment de l’envoi)."
          },
          "emailConfig": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant de la configuration d’envoi d’email à utiliser (voir GET /messaging-configs)."
          },
          "smsConfig": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant d’une configuration SMS — accepté pour compatibilité, mais IGNORÉ par le processus SMS (configuration unique par organisation)."
          },
          "whatsappAccountId": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant du numéro WhatsApp émetteur (obligatoire lorsque type contient WHATSAPP)."
          },
          "allContact": {
            "type": "boolean",
            "description": "Ciblage : tous les contacts."
          },
          "staredOnly": {
            "type": "boolean",
            "description": "Ciblage : contacts locaux/épinglés (module Proximité)."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Ciblage : contacts appartenant à l’une de ces catégories."
          },
          "familles": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Champ historique, enregistré mais NON utilisé pour le ciblage."
          },
          "docs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CampaignMedia"
            }
          },
          "videos": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CampaignMedia"
            }
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CampaignLink"
            }
          },
          "prefix": {
            "type": "string"
          },
          "scheduledAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "Heure d’envoi (null = immédiatement après l’envoi de la commande)."
          },
          "datetime": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "targets": {
            "type": "integer",
            "readOnly": true,
            "description": "Nombre de livraisons (après l’envoi)."
          },
          "percentSuccess": {
            "type": "string",
            "readOnly": true
          },
          "percentError": {
            "type": "string",
            "readOnly": true
          }
        }
      },
      "CampaignInput": {
        "type": "object",
        "description": "Les campagnes ciblant des listes de contacts exposent crmTarget en lecture ; leur modification, l’aperçu des destinataires et l’envoi nécessitent une revue du back-office (CONTACT_LIST_REVIEW_REQUIRED). Cette API refuse toute nouvelle valeur crmTarget. Créez ou modifiez une campagne de messages. Le ciblage est EXCLUSIF : définissez exactement l’un de `allContact`, `staredOnly` ou `categories`.\nLorsque `type` contient WHATSAPP, `whatsappAccountId` est OBLIGATOIRE et doit correspondre à un numéro connecté (voir GET /whatsapp-accounts).\nMédias (`docs`/`videos`) : le champ `doc` de chaque élément peut être une URL http(s) (réhébergée) ou un nom de fichier renvoyé par POST /uploads.\nUne campagne est créée dans l’état INIT (brouillon) ; elle ne peut être modifiée que dans cet état. L’envoi est une action distincte (POST /{id}/send, scope messages:send).",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "WHATSAPP",
              "SMS",
              "EMAIL",
              "WHATSAPP_OU_SMS",
              "WHATSAPP_OU_EMAIL",
              "WHATSAPP_OU_SMS_OU_EMAIL",
              "SMS_OU_EMAIL"
            ],
            "description": "Obligatoire à la création."
          },
          "whatsappAccountId": {
            "type": "string",
            "description": "Obligatoire lorsque type contient WHATSAPP."
          },
          "subject": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "emailContent": {
            "type": "string"
          },
          "emailTemplate": {
            "type": "string",
            "description": "Identifiant d’un modèle d’email existant."
          },
          "emailConfig": {
            "type": "string",
            "description": "Identifiant d’une configuration email existante (GET /messaging-configs)."
          },
          "smsConfig": {
            "type": "string",
            "description": "Identifiant d’une configuration SMS (accepté mais ignoré par le processus)."
          },
          "allContact": {
            "type": "boolean"
          },
          "staredOnly": {
            "type": "boolean"
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "familles": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "docs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CampaignMedia"
            }
          },
          "videos": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CampaignMedia"
            }
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CampaignLink"
            }
          },
          "prefix": {
            "type": "string"
          },
          "scheduledAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        }
      },
      "CampaignTargets": {
        "type": "object",
        "properties": {
          "total": {
            "type": "integer",
            "description": "Nombre de destinataires correspondant au ciblage."
          }
        }
      },
      "CampaignTestInput": {
        "type": "object",
        "required": [
          "contactId"
        ],
        "properties": {
          "contactId": {
            "type": "string",
            "description": "Contact auquel envoyer le message de test."
          }
        }
      },
      "UploadResult": {
        "type": "object",
        "properties": {
          "filename": {
            "type": "string",
            "description": "Nom de fichier hébergé — à placer dans `docs[].doc` / `videos[].doc` d’une campagne."
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "mimetype": {
            "type": "string"
          },
          "size": {
            "type": "integer"
          }
        }
      },
      "WhatsappAccount": {
        "type": "object",
        "description": "Numéro WhatsApp connecté (lecture seule). Choisissez l’identifiant d’un numéro `ready` comme whatsappAccountId de la campagne.",
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true
          },
          "label": {
            "type": "string",
            "readOnly": true
          },
          "status": {
            "type": "string",
            "enum": [
              "created",
              "initializing",
              "qr_ready",
              "authenticating",
              "ready",
              "disconnected",
              "failed"
            ],
            "readOnly": true,
            "description": "`ready` = connecté et utilisable."
          },
          "phone": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "pushName": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "isDefault": {
            "type": "boolean",
            "readOnly": true
          },
          "active": {
            "type": "boolean",
            "readOnly": true
          },
          "dailyCap": {
            "type": "integer",
            "nullable": true,
            "readOnly": true,
            "description": "Limite quotidienne d’envoi ; 0 = illimitée ; null = montée en charge automatique progressive du quota."
          },
          "connectedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          }
        }
      },
      "WhatsappAccountStatus": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string"
          },
          "ready": {
            "type": "boolean"
          },
          "phone": {
            "type": "string",
            "nullable": true
          },
          "pushName": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "MessagingConfigs": {
        "type": "object",
        "description": "Configurations d’envoi d’emails et de SMS de l’organisation (sans secrets). Utilisez l’identifiant d’une entrée email comme emailConfig de campagne. La configuration SMS est unique par organisation (le champ smsConfig d’une campagne est ignoré par le processus).",
        "properties": {
          "email": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "type": "string",
                  "nullable": true
                },
                "sender": {
                  "type": "string",
                  "nullable": true,
                  "description": "Adresse d’expédition."
                },
                "replyTo": {
                  "type": "string",
                  "nullable": true
                },
                "provider": {
                  "type": "string",
                  "nullable": true
                }
              }
            }
          },
          "sms": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "nullable": true
                },
                "name": {
                  "type": "string",
                  "nullable": true,
                  "description": "Nom d’expéditeur SMS (identifiant d’origine)."
                },
                "provider": {
                  "type": "string",
                  "nullable": true
                },
                "quota": {
                  "type": "integer",
                  "nullable": true,
                  "description": "Crédits SMS restants."
                },
                "active": {
                  "type": "boolean"
                }
              }
            }
          }
        }
      },
      "MenuItem": {
        "type": "object",
        "description": "Élément de menu du site, nœud d’une arborescence par site (parent/position). Lien libre (nom+url) ou lien vers une entité (type + targetId).",
        "properties": {
          "id": {
            "type": "string"
          },
          "organisation": {
            "type": "string"
          },
          "virtualId": {
            "type": "string",
            "nullable": true,
            "description": "Périmètre du site : null = site principal, sinon identifiant d’un site virtuel."
          },
          "type": {
            "type": "string",
            "enum": [
              "LINK",
              "PAGE",
              "FORM",
              "CAGNOTTE",
              "ACCOUNT",
              "DYNAMIC_ARTICLES"
            ],
            "description": "Type d’élément. LINK = lien libre (name+url). PAGE/FORM/CAGNOTTE = lien vers une entité (définir targetId ; le libellé est résolu à partir de la cible). ACCOUNT = lien fixe vers l’espace de compte membre (url \"/account\", nom modifiable). DYNAMIC_ARTICLES = liste d’articles (url \"\")."
          },
          "name": {
            "type": "string",
            "description": "Libellé affiché (vide pour les liens FORM/CAGNOTTE, qui reprennent le nom de leur cible)."
          },
          "url": {
            "type": "string",
            "description": "URL cible d’un lien libre (vide pour les liens vers une entité ; \"/account\" pour ACCOUNT)."
          },
          "targetId": {
            "type": "string",
            "description": "Identifiant de l’entité associée (obligatoire si type est PAGE/FORM/CAGNOTTE)."
          },
          "parent": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant de l’élément parent (null = racine)."
          },
          "position": {
            "type": "integer",
            "description": "Ordre de tri parmi les éléments frères."
          },
          "platform": {
            "type": "string",
            "enum": [
              "ALL",
              "ONLY_DESKTOP",
              "ONLY_APPMOBILE"
            ],
            "description": "Surface d’affichage : ALL = site web sur ordinateur et application mobile native ; ONLY_DESKTOP = site web sur ordinateur uniquement ; ONLY_APPMOBILE = application mobile native uniquement. ALL par défaut."
          }
        }
      },
      "MenuItemInput": {
        "type": "object",
        "description": "Données pour créer ou modifier le CONTENU d’un élément de menu. Sa structure (parent/position) n’est PAS définie ici — utilisez POST /menu/reorder. À la création, l’élément est ajouté à la fin du niveau racine.",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "LINK",
              "PAGE",
              "FORM",
              "CAGNOTTE",
              "ACCOUNT",
              "DYNAMIC_ARTICLES"
            ],
            "description": "Type d’élément. LINK = lien libre (name+url). PAGE/FORM/CAGNOTTE = lien vers une entité (définir targetId). ACCOUNT = espace de compte membre — définir url à \"/account\". DYNAMIC_ARTICLES = liste d’articles — définir url à \"\"."
          },
          "name": {
            "type": "string",
            "description": "Libellé affiché (utilisez \"\" pour les liens FORM/CAGNOTTE)."
          },
          "url": {
            "type": "string",
            "description": "URL cible d’un lien libre (utilisez \"\" pour les liens vers une entité ; \"/account\" pour ACCOUNT)."
          },
          "targetId": {
            "type": "string",
            "description": "Identifiant de l’entité associée — obligatoire si type est PAGE/FORM/CAGNOTTE."
          },
          "virtualId": {
            "type": "string",
            "nullable": true,
            "description": "Site auquel rattacher l’élément (null/omis = site principal)."
          },
          "platform": {
            "type": "string",
            "enum": [
              "ALL",
              "ONLY_DESKTOP",
              "ONLY_APPMOBILE"
            ],
            "description": "Surface d’affichage de cet élément. ALL = site web sur ordinateur + application mobile native ; ONLY_DESKTOP = site web sur ordinateur uniquement ; ONLY_APPMOBILE = application mobile native uniquement. Valeur omise/invalide → ALL. À envoyer uniquement pour la modifier (omise lors d’une édition, la valeur actuelle est conservée)."
          }
        }
      },
      "MenuReorderInput": {
        "type": "object",
        "description": "Définir le parent et la position des éléments de menu en une seule opération atomique (glisser-déposer / arborescence). Envoyez la disposition complète souhaitée.",
        "required": [
          "items"
        ],
        "properties": {
          "virtualId": {
            "type": "string",
            "nullable": true,
            "description": "Périmètre du site (null/omis = site principal)."
          },
          "items": {
            "type": "array",
            "description": "Disposition souhaitée.",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "parent": {
                  "type": "string",
                  "nullable": true,
                  "description": "Identifiant de l’élément parent (null = racine)."
                },
                "position": {
                  "type": "integer"
                }
              }
            }
          }
        }
      },
      "SubmitRequest": {
        "type": "object",
        "required": [
          "formId"
        ],
        "properties": {
          "formId": {
            "type": "string",
            "description": "Identifiant du formulaire cible (doit appartenir à l’organisation de la clé API)."
          },
          "devise": {
            "type": "string",
            "description": "Devise de la soumission. Par défaut, devise du formulaire.",
            "nullable": true
          },
          "data": {
            "type": "object",
            "description": "Données de soumission libres. Clés courantes : `identity` (objet contact), `__promo`, `__paiementMethod`, `[CONTACT]_*`, `[HAZKARA]_*`, `[CHILD]_*`, `[FREE_AMOUNT]_*`, `<productId>_quantity`. Remarque : `data.extra.editId` est refusé pour les intégrations.",
            "additionalProperties": true
          }
        }
      },
      "SubmitResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/FormSubmit"
          },
          "url": {
            "type": "string",
            "nullable": true,
            "description": "URL du lien de paiement si la soumission nécessite un paiement ; sinon null."
          }
        }
      },
      "PaymentRequest": {
        "type": "object",
        "required": [
          "config"
        ],
        "properties": {
          "config": {
            "type": "object",
            "description": "Même structure que les données envoyées par le site web au endpoint de paiement public. La couche d’intégration force `config.organisation` à correspondre à l’organisation de la clé API.",
            "required": [
              "type",
              "montant"
            ],
            "properties": {
              "externalRef": {
                "type": "string",
                "minLength": 1,
                "maxLength": 255,
                "pattern": "\\S",
                "example": "commande-1234",
                "description": "Référence facultative dans votre système. Non vide, enregistrée telle quelle ; correspondance exacte sensible à la casse. Non unique et ne constitue PAS une clé d’idempotence. À distinguer de externalId (dédoublonnage à l’import). Renvoyée lors de la lecture des paiements et dans les webhooks de paiement si elle est fournie. Héritée par les paiements récurrents."
              },
              "externalMetadata": {
                "type": "object",
                "maxProperties": 50,
                "additionalProperties": {
                  "type": "string",
                  "maxLength": 500
                },
                "example": {
                  "registrationId": "inscription-567",
                  "eventId": "chabbat-890"
                },
                "description": "Carte facultative de chaînes clé-valeur gérée par l’appelant. Jusqu’à 50 clés (1–64 caractères chacune), valeurs de 500 caractères maximum. Les clés ne peuvent contenir . ou $, ni le caractère NUL, et ne peuvent être égales à __proto__, prototype ou constructor. Les valeurs null, tableaux, objets imbriqués et valeurs non textuelles sont refusés. Enregistrée telle quelle et renvoyée lors de la lecture des paiements et dans les webhooks ; héritée par les paiements récurrents. Distincte des métadonnées du fournisseur ; évitez d’y placer des secrets. Aucun de ces champs n’est obligatoire pour les paiements historiques."
              },
              "type": {
                "type": "string",
                "enum": [
                  "GENERAL",
                  "FORM",
                  "DETTE",
                  "CAISSE",
                  "SERVICE",
                  "CAMPAGNE"
                ]
              },
              "typeId": {
                "type": "string",
                "nullable": true,
                "description": "Identifiant de l’entité cible (obligatoire sauf si type=GENERAL)."
              },
              "montant": {
                "type": "number",
                "description": "Montant en unités majeures (par ex. euros)."
              },
              "devise": {
                "type": "string",
                "nullable": true
              },
              "name": {
                "type": "string",
                "nullable": true
              },
              "info": {
                "$ref": "#/components/schemas/PaiementInfo"
              },
              "facturation": {
                "$ref": "#/components/schemas/PaiementFacturation"
              },
              "returnUrl": {
                "type": "string",
                "nullable": true
              },
              "platform": {
                "type": "string",
                "nullable": true,
                "description": "Forcer une plateforme spécifique (par ex. STRIPE.SEPA, PAYME.IDD, PAYPAL)."
              },
              "abo": {
                "type": "boolean",
                "nullable": true
              },
              "nbMonth": {
                "type": "integer",
                "nullable": true
              },
              "maxAmount": {
                "type": "integer",
                "nullable": true
              }
            }
          }
        }
      },
      "PaymentResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "paiementId": {
            "type": "string",
            "nullable": true
          },
          "url": {
            "type": "string",
            "nullable": true,
            "description": "URL de la page de paiement hébergée."
          },
          "clientSecret": {
            "type": "string",
            "nullable": true,
            "description": "Renvoyé par certains fournisseurs de type Stripe pour une interface intégrée."
          },
          "error": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "PaymentRefundRequest": {
        "type": "object",
        "properties": {
          "reason": {
            "type": "string",
            "enum": [
              "requested_by_customer",
              "duplicate",
              "fraudulent"
            ],
            "default": "requested_by_customer"
          },
          "message": {
            "type": "string",
            "description": "Note interne facultative enregistrée dans l’historique d’audit du remboursement."
          },
          "pauseAbo": {
            "type": "boolean",
            "default": false,
            "description": "Mettre également en pause l’abonnement associé, s’il existe."
          }
        }
      },
      "PaymentRefundResponse": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "pending": {
            "type": "boolean",
            "description": "Le résultat du remboursement n’est pas confirmé. Vérifiez auprès du fournisseur avant de réessayer."
          },
          "refundId": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "string",
            "nullable": true
          },
          "error": {
            "type": "string",
            "nullable": true
          },
          "message": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "WebhookEventEnvelope": {
        "type": "object",
        "description": "Enveloppe commune des requêtes HTTP POST sortantes. `data` est un instantané de la ressource, pas la réponse synchrone de l’API. Voir x-webhooks pour les schémas d’événements, en-têtes, exemples et vérification de signature.",
        "required": [
          "id",
          "type",
          "organisation",
          "createdAt",
          "attempt",
          "data"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifiant d’événement opaque et stable pour la déduplication (généralement un UUID ; n’exigez pas un format UUID)."
          },
          "type": {
            "type": "string",
            "example": "paiement.success"
          },
          "organisation": {
            "type": "string"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "attempt": {
            "type": "integer",
            "minimum": 1,
            "description": "Numéro de tentative (≥1) ; l’identifiant d’événement reste stable lors des nouvelles tentatives."
          },
          "data": {
            "type": "object",
            "description": "Instantané de la ressource affectée. Le schéma dépend du type d’événement."
          }
        }
      },
      "EventLink": {
        "type": "object",
        "description": "Lien d’action public pour l’événement (formulaire d’inscription ou cagnotte de dons).",
        "properties": {
          "name": {
            "type": "string",
            "readOnly": true,
            "description": "Libellé du lien (localisé ; voir les surcharges par langue)."
          },
          "url": {
            "type": "string",
            "readOnly": true,
            "description": "URL publique (page /form/… ou /don/…)."
          }
        }
      },
      "Event": {
        "type": "object",
        "description": "Session autonome de Parcours d’Événement : occasion datée à laquelle les visiteurs peuvent s’inscrire ou contribuer. Lecture seule — les événements (avec leurs formulaires, cagnottes et livrets budgétaires) sont créés dans l’application admin. Les groupes d’événements à sessions multiples et les groupes système (par ex. Shabbat, exposé via l’API Travel) ne sont PAS listés ici. Les champs texte localisés contiennent la langue par défaut à la racine, avec des surcharges facultatives par langue (`fr`/`en`/`he`/`de`/`gr`…).",
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true
          },
          "name": {
            "type": "string",
            "nullable": true,
            "readOnly": true,
            "description": "Titre public de la session."
          },
          "description": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "dateEvent": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "description": "Date/heure de début."
          },
          "dateFin": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "description": "Date/heure de fin."
          },
          "dateDebut": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "description": "Date à partir de laquelle l’événement devient visible."
          },
          "image": {
            "type": "string",
            "nullable": true,
            "readOnly": true,
            "description": "Affiche/illustration (nom de fichier hébergé ou URL)."
          },
          "adresse": {
            "type": "string",
            "nullable": true,
            "readOnly": true,
            "description": "Adresse du lieu, si définie."
          },
          "links": {
            "type": "array",
            "readOnly": true,
            "items": {
              "$ref": "#/components/schemas/EventLink"
            },
            "description": "Formulaires d’inscription et cagnottes de dons actifs associés à cet événement."
          }
        }
      },
      "ShabbatGroup": {
        "type": "object",
        "nullable": true,
        "description": "Métadonnées du groupe Shabbat du site. null si aucun Shabbat n’est configuré sur le site.",
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true
          },
          "label": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "title": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "description": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "image": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "aiContentBlockId": {
            "type": "string",
            "nullable": true,
            "readOnly": true,
            "description": "Identifiant d’un bloc de contenu IA affichant l’introduction du groupe (à lire via /content-blocks/{id})."
          },
          "mode": {
            "type": "string",
            "readOnly": true,
            "example": "MULTI_SESSION"
          }
        }
      },
      "ShabbatBundle": {
        "type": "object",
        "description": "Repas/sessions de Shabbat d’un site Travel (lecture seule). Les sessions ont la même structure que les événements autonomes. Les zmanim (heures d’entrée et de sortie du Shabbat) ne sont pas inclus dans cette version.",
        "properties": {
          "group": {
            "$ref": "#/components/schemas/ShabbatGroup"
          },
          "sessions": {
            "type": "array",
            "readOnly": true,
            "items": {
              "$ref": "#/components/schemas/Event"
            },
            "description": "Sessions Shabbat à venir/actives, triées par date de début."
          }
        }
      },
      "TravelSite": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "virtual": {
            "type": "string",
            "nullable": true
          },
          "label": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "I18nOverlay": {
        "type": "object",
        "description": "**Convention multilingue commune à tous les objets traduisibles de cette API.**\n\nIl n’existe pas de correspondance `{fr:…, en:…}`. La valeur dans la langue par DÉFAUT de l’organisation (`org.language`) se trouve à la **RACINE** de l’objet — elle n’est PAS imbriquée sous sa propre clé de langue. Chaque AUTRE langue activée par l’organisation (`org.languages`) est une **surcharge partielle**, indexée par son code de langue et ne contenant que les champs traduisibles.\n\n```json\n{ \"label\": \"Restaurant\", \"he\": { \"label\": \"מסעדה\" } }   // org default = French\n```\n\nLes clés de surcharge valides sont **dynamiques pour chaque organisation** : ses langues activées, moins la langue par défaut. Une organisation dont le français est la langue par défaut utilise des surcharges `en`/`he`/… ; une organisation dont l’anglais est la langue par défaut peut utiliser une surcharge `fr`. L’envoi de la langue par défaut comme surcharge est rejeté (cela dupliquerait la racine) ; une langue non prise en charge est ignorée sans avertissement. Un champ absent d’une surcharge reprend la valeur de la racine.\n\n**Écrire/modifier une traduction :** envoyez la surcharge avec sa valeur — elle sera créée ou remplacée.\n\n**Supprimer une traduction :** définissez la surcharge à `null` → `{ \"he\": null }` supprime toute la surcharge `he`. Lors d’une mise à jour partielle (PATCH), omettre une clé signifie *« la laisser telle quelle »* ; `null` est donc le SEUL moyen de supprimer une traduction. Une surcharge explicitement vide (`{ \"he\": {} }`) est également traitée comme une suppression, puisqu’elle ne contient aucune traduction.\n\n**L’opération est contrôlée selon la langue par défaut, pas la clé.** L’écriture de cette langue comme surcharge est rejetée (`{ \"fr\": { \"label\": \"…\" } }` dans une organisation dont le français est la langue par défaut) — elle doit se trouver à la racine. Mais `{ \"fr\": null }` est ACCEPTÉ et supprime une surcharge dans cette langue. C’est important après le changement de langue par défaut d’une organisation : une surcharge dans la NOUVELLE langue par défaut persiste dans les documents et prévaut sur la valeur racine à l’affichage ; sa suppression doit donc rester possible.\n\nAppelez `GET /me` ou consultez les paramètres de l’organisation pour connaître les langues activées.",
        "example": {
          "label": "Restaurant",
          "he": {
            "label": "מסעדה"
          },
          "en": null
        }
      },
      "TravelConfigChabbat": {
        "type": "object",
        "properties": {
          "active": {
            "type": "boolean",
            "description": "Show the site's existing native Shabbat module and its published registrations."
          }
        },
        "description": "Visibility of the native Shabbat registration module on this Travel site. Enabling it does not create a group, calendar, session or form; use the dedicated native Shabbat management operations first. This flag is separate from recurring-session automation."
      },
      "TravelConfigTheme": {
        "type": "object",
        "properties": {
          "primaryColor": {
            "type": "string",
            "description": "Couleur principale de la marque au format hexadécimal (par ex. \"#1b579e\"). Utilisée pour les boutons, liens et accents."
          },
          "secondaryColor": {
            "type": "string",
            "description": "Couleur secondaire/d’accent au format hexadécimal (par ex. \"#38b6ff\")."
          }
        },
        "description": "Thème visuel du site Travel — couleurs de marque."
      },
      "TravelConfigJewishInfo": {
        "type": "object",
        "properties": {
          "eruv": {
            "type": "string",
            "enum": [
              "yes",
              "no",
              "partial"
            ],
            "description": "Indique si la ville possède un érouv : \"yes\" (complet), \"no\" (aucun) ou \"partial\" (couvrant une partie seulement de la zone, par ex. le centre-ville)."
          },
          "eruvComment": {
            "type": "string",
            "description": "Note en texte libre sur l’érouv (par ex. zone couverte). Affichée lorsque `eruv` est défini."
          },
          "tourismInfos": {
            "type": "string",
            "description": "Informations générales sur le tourisme juif dans la destination, au format HTML (texte enrichi)."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eruvComment": {
                "type": "string",
                "description": "Note en texte libre sur l’érouv (par ex. zone couverte). Affichée lorsque `eruv` est défini."
              },
              "tourismInfos": {
                "type": "string",
                "description": "Informations générales sur le tourisme juif dans la destination, au format HTML (texte enrichi)."
              }
            }
          },
          "en": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eruvComment": {
                "type": "string",
                "description": "Note en texte libre sur l’érouv (par ex. zone couverte). Affichée lorsque `eruv` est défini."
              },
              "tourismInfos": {
                "type": "string",
                "description": "Informations générales sur le tourisme juif dans la destination, au format HTML (texte enrichi)."
              }
            }
          },
          "he": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eruvComment": {
                "type": "string",
                "description": "Note en texte libre sur l’érouv (par ex. zone couverte). Affichée lorsque `eruv` est défini."
              },
              "tourismInfos": {
                "type": "string",
                "description": "Informations générales sur le tourisme juif dans la destination, au format HTML (texte enrichi)."
              }
            }
          },
          "it": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eruvComment": {
                "type": "string",
                "description": "Note en texte libre sur l’érouv (par ex. zone couverte). Affichée lorsque `eruv` est défini."
              },
              "tourismInfos": {
                "type": "string",
                "description": "Informations générales sur le tourisme juif dans la destination, au format HTML (texte enrichi)."
              }
            }
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eruvComment": {
                "type": "string",
                "description": "Note en texte libre sur l’érouv (par ex. zone couverte). Affichée lorsque `eruv` est défini."
              },
              "tourismInfos": {
                "type": "string",
                "description": "Informations générales sur le tourisme juif dans la destination, au format HTML (texte enrichi)."
              }
            }
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eruvComment": {
                "type": "string",
                "description": "Note en texte libre sur l’érouv (par ex. zone couverte). Affichée lorsque `eruv` est défini."
              },
              "tourismInfos": {
                "type": "string",
                "description": "Informations générales sur le tourisme juif dans la destination, au format HTML (texte enrichi)."
              }
            }
          },
          "de": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eruvComment": {
                "type": "string",
                "description": "Note en texte libre sur l’érouv (par ex. zone couverte). Affichée lorsque `eruv` est défini."
              },
              "tourismInfos": {
                "type": "string",
                "description": "Informations générales sur le tourisme juif dans la destination, au format HTML (texte enrichi)."
              }
            }
          },
          "es": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eruvComment": {
                "type": "string",
                "description": "Note en texte libre sur l’érouv (par ex. zone couverte). Affichée lorsque `eruv` est défini."
              },
              "tourismInfos": {
                "type": "string",
                "description": "Informations générales sur le tourisme juif dans la destination, au format HTML (texte enrichi)."
              }
            }
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eruvComment": {
                "type": "string",
                "description": "Note en texte libre sur l’érouv (par ex. zone couverte). Affichée lorsque `eruv` est défini."
              },
              "tourismInfos": {
                "type": "string",
                "description": "Informations générales sur le tourisme juif dans la destination, au format HTML (texte enrichi)."
              }
            }
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eruvComment": {
                "type": "string",
                "description": "Note en texte libre sur l’érouv (par ex. zone couverte). Affichée lorsque `eruv` est défini."
              },
              "tourismInfos": {
                "type": "string",
                "description": "Informations générales sur le tourisme juif dans la destination, au format HTML (texte enrichi)."
              }
            }
          }
        },
        "description": "Informations halakhiques / destinées aux voyageurs juifs sur la destination (état de l’érouv, informations touristiques générales).",
        "required": [
          "eruv"
        ]
      },
      "TravelConfigHoraires": {
        "type": "object",
        "properties": {
          "content": {
            "type": "string",
            "description": "Contenu en texte libre pour la page des horaires/zmanim, au format HTML."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "content": {
                "type": "string",
                "description": "Contenu en texte libre pour la page des horaires/zmanim, au format HTML."
              }
            }
          },
          "en": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "content": {
                "type": "string",
                "description": "Contenu en texte libre pour la page des horaires/zmanim, au format HTML."
              }
            }
          },
          "he": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "content": {
                "type": "string",
                "description": "Contenu en texte libre pour la page des horaires/zmanim, au format HTML."
              }
            }
          },
          "it": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "content": {
                "type": "string",
                "description": "Contenu en texte libre pour la page des horaires/zmanim, au format HTML."
              }
            }
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "content": {
                "type": "string",
                "description": "Contenu en texte libre pour la page des horaires/zmanim, au format HTML."
              }
            }
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "content": {
                "type": "string",
                "description": "Contenu en texte libre pour la page des horaires/zmanim, au format HTML."
              }
            }
          },
          "de": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "content": {
                "type": "string",
                "description": "Contenu en texte libre pour la page des horaires/zmanim, au format HTML."
              }
            }
          },
          "es": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "content": {
                "type": "string",
                "description": "Contenu en texte libre pour la page des horaires/zmanim, au format HTML."
              }
            }
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "content": {
                "type": "string",
                "description": "Contenu en texte libre pour la page des horaires/zmanim, au format HTML."
              }
            }
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "content": {
                "type": "string",
                "description": "Contenu en texte libre pour la page des horaires/zmanim, au format HTML."
              }
            }
          }
        },
        "description": "Bloc de texte libre « horaires / zmanim » du site."
      },
      "TravelConfigMenu": {
        "type": "object",
        "properties": {
          "button_1_label": {
            "type": "string",
            "description": "Libellé du bouton de menu 1 (vide = aucun bouton)."
          },
          "button_1_url": {
            "type": "string",
            "description": "Cible du bouton de menu 1 — chemin interne (par ex. \"/don\") ou URL complète."
          },
          "button_1_icon": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
              },
              "source": {
                "type": "string",
                "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
              }
            },
            "description": "Icône du bouton de menu 1."
          },
          "button_2_label": {
            "type": "string",
            "description": "Libellé du bouton de menu 2 (vide = aucun bouton)."
          },
          "button_2_url": {
            "type": "string",
            "description": "Cible du bouton de menu 2 — chemin interne ou URL complète."
          },
          "button_2_icon": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
              },
              "source": {
                "type": "string",
                "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
              }
            },
            "description": "Icône du bouton de menu 2."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 1 (vide = aucun bouton)."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 2 (vide = aucun bouton)."
              }
            }
          },
          "en": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 1 (vide = aucun bouton)."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 2 (vide = aucun bouton)."
              }
            }
          },
          "he": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 1 (vide = aucun bouton)."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 2 (vide = aucun bouton)."
              }
            }
          },
          "it": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 1 (vide = aucun bouton)."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 2 (vide = aucun bouton)."
              }
            }
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 1 (vide = aucun bouton)."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 2 (vide = aucun bouton)."
              }
            }
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 1 (vide = aucun bouton)."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 2 (vide = aucun bouton)."
              }
            }
          },
          "de": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 1 (vide = aucun bouton)."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 2 (vide = aucun bouton)."
              }
            }
          },
          "es": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 1 (vide = aucun bouton)."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 2 (vide = aucun bouton)."
              }
            }
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 1 (vide = aucun bouton)."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 2 (vide = aucun bouton)."
              }
            }
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 1 (vide = aucun bouton)."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du bouton de menu 2 (vide = aucun bouton)."
              }
            }
          }
        },
        "description": "Les deux boutons d’appel à l’action facultatifs affichés dans le menu de navigation du site (2 maximum)."
      },
      "TravelConfigHeroBanner": {
        "type": "object",
        "properties": {
          "slides": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "image": {
                  "type": "string",
                  "description": "Image d’arrière-plan de la diapositive (obligatoire). Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
                },
                "eyebrow_icon": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
                    },
                    "source": {
                      "type": "string",
                      "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
                    }
                  },
                  "description": "Petite icône affichée à côté du texte introductif."
                },
                "eyebrow": {
                  "type": "string",
                  "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                },
                "title": {
                  "type": "string",
                  "description": "Titre principal de la diapositive."
                },
                "subtitle": {
                  "type": "string",
                  "description": "Ligne secondaire sous le titre."
                },
                "description": {
                  "type": "string",
                  "description": "Paragraphe descriptif plus long pour la diapositive."
                },
                "btn1_label": {
                  "type": "string",
                  "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                },
                "btn1_url": {
                  "type": "string",
                  "description": "URL cible du premier bouton."
                },
                "btn1_icon": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
                    },
                    "source": {
                      "type": "string",
                      "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
                    }
                  },
                  "description": "Icône du premier bouton."
                },
                "btn2_label": {
                  "type": "string",
                  "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                },
                "btn2_url": {
                  "type": "string",
                  "description": "URL cible du deuxième bouton."
                },
                "btn2_icon": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
                    },
                    "source": {
                      "type": "string",
                      "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
                    }
                  },
                  "description": "Icône du deuxième bouton."
                },
                "fr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "en": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "he": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "it": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "ru": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "pt": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "de": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "es": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "gr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "ro": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                }
              },
              "required": [
                "image"
              ]
            },
            "description": "Liste ordonnée des diapositives de la bannière principale affichées dans le carrousel de la page d’accueil."
          }
        },
        "description": "Carrousel de la bannière principale de la page d’accueil (grandes diapositives en haut du site)."
      },
      "TravelConfigHomepage": {
        "type": "object",
        "properties": {
          "showArticles": {
            "type": "boolean",
            "description": "Indique si l’aperçu automatique des articles est affiché sur la page d’accueil. false masque la section et empêche la requête de prévisualisation. Omission = affichée (comportement historique)."
          },
          "aiContentBlockId": {
            "type": "string",
            "description": "Identifiant d’un bloc de contenu IA (HTML libre) affiché sur la page d’accueil. null = aucun. Pour ÉCRIRE le HTML de ce bloc, utilisez la ressource Content Blocks : PUT /content-blocks/{id}/content (upsert ; vous pouvez donc définir ici n’importe quel identifiant puis écrire son contenu) et GET /content-blocks/{id} pour le relire."
          },
          "banners": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "image": {
                  "type": "string",
                  "description": "Image d’arrière-plan de la diapositive (obligatoire). Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
                },
                "eyebrow_icon": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
                    },
                    "source": {
                      "type": "string",
                      "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
                    }
                  },
                  "description": "Petite icône affichée à côté du texte introductif."
                },
                "eyebrow": {
                  "type": "string",
                  "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                },
                "title": {
                  "type": "string",
                  "description": "Titre principal de la diapositive."
                },
                "subtitle": {
                  "type": "string",
                  "description": "Ligne secondaire sous le titre."
                },
                "description": {
                  "type": "string",
                  "description": "Paragraphe descriptif plus long pour la diapositive."
                },
                "btn1_label": {
                  "type": "string",
                  "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                },
                "btn1_url": {
                  "type": "string",
                  "description": "URL cible du premier bouton."
                },
                "btn1_icon": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
                    },
                    "source": {
                      "type": "string",
                      "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
                    }
                  },
                  "description": "Icône du premier bouton."
                },
                "btn2_label": {
                  "type": "string",
                  "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                },
                "btn2_url": {
                  "type": "string",
                  "description": "URL cible du deuxième bouton."
                },
                "btn2_icon": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
                    },
                    "source": {
                      "type": "string",
                      "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
                    }
                  },
                  "description": "Icône du deuxième bouton."
                },
                "fr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "en": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "he": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "it": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "ru": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "pt": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "de": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "es": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "gr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "ro": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                }
              },
              "required": [
                "image"
              ]
            },
            "description": "Bannières promotionnelles larges affichées plus bas sur la page d’accueil (même structure que les diapositives de la bannière principale). Vide = section des bannières masquée."
          }
        },
        "description": "Contenu de la page d’accueil en plus du visuel principal : bloc de contenu IA facultatif et bannières promotionnelles réutilisables."
      },
      "TravelConfigBethHabad": {
        "type": "object",
        "properties": {
          "about": {
            "type": "string",
            "description": "Texte de présentation du Beth Habad, au format HTML."
          },
          "contacts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "type": "string",
                  "description": "Nom complet de la personne (par ex. \"Rav Ouziel Friedland\")."
                },
                "role": {
                  "type": "string",
                  "description": "Titre/fonction (par ex. \"Shaliah\", \"Director\")."
                },
                "avatar": {
                  "type": "string",
                  "description": "Photo de la personne. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
                },
                "phone": {
                  "type": "string",
                  "description": "Numéro de téléphone."
                },
                "email": {
                  "type": "string",
                  "description": "Adresse email."
                },
                "whatsapp": {
                  "type": "string",
                  "description": "Numéro WhatsApp."
                },
                "fr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "role": {
                      "type": "string",
                      "description": "Titre/fonction (par ex. \"Shaliah\", \"Director\")."
                    }
                  }
                },
                "en": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "role": {
                      "type": "string",
                      "description": "Titre/fonction (par ex. \"Shaliah\", \"Director\")."
                    }
                  }
                },
                "he": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "role": {
                      "type": "string",
                      "description": "Titre/fonction (par ex. \"Shaliah\", \"Director\")."
                    }
                  }
                },
                "it": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "role": {
                      "type": "string",
                      "description": "Titre/fonction (par ex. \"Shaliah\", \"Director\")."
                    }
                  }
                },
                "ru": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "role": {
                      "type": "string",
                      "description": "Titre/fonction (par ex. \"Shaliah\", \"Director\")."
                    }
                  }
                },
                "pt": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "role": {
                      "type": "string",
                      "description": "Titre/fonction (par ex. \"Shaliah\", \"Director\")."
                    }
                  }
                },
                "de": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "role": {
                      "type": "string",
                      "description": "Titre/fonction (par ex. \"Shaliah\", \"Director\")."
                    }
                  }
                },
                "es": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "role": {
                      "type": "string",
                      "description": "Titre/fonction (par ex. \"Shaliah\", \"Director\")."
                    }
                  }
                },
                "gr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "role": {
                      "type": "string",
                      "description": "Titre/fonction (par ex. \"Shaliah\", \"Director\")."
                    }
                  }
                },
                "ro": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "role": {
                      "type": "string",
                      "description": "Titre/fonction (par ex. \"Shaliah\", \"Director\")."
                    }
                  }
                }
              },
              "required": [
                "name",
                "role"
              ]
            },
            "description": "Membres de l’équipe du Beth Habad (le Shaliah, la Shlou'ha, etc.). Le PREMIER contact est considéré comme la personne responsable à prévenir des nouvelles demandes d’annonce de voyage."
          },
          "contactChannels": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "phone",
                    "email",
                    "whatsapp"
                  ],
                  "description": "Type de canal : \"phone\", \"email\" ou \"whatsapp\". Pour \"whatsapp\", `value` peut être un lien d’invitation à un groupe."
                },
                "value": {
                  "type": "string",
                  "description": "Numéro, adresse email ou lien de ce canal."
                },
                "label": {
                  "type": "string",
                  "description": "Légende facultative (par ex. \"Groupe WhatsApp des voyageurs\")."
                },
                "fr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Légende facultative (par ex. \"Groupe WhatsApp des voyageurs\")."
                    }
                  }
                },
                "en": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Légende facultative (par ex. \"Groupe WhatsApp des voyageurs\")."
                    }
                  }
                },
                "he": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Légende facultative (par ex. \"Groupe WhatsApp des voyageurs\")."
                    }
                  }
                },
                "it": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Légende facultative (par ex. \"Groupe WhatsApp des voyageurs\")."
                    }
                  }
                },
                "ru": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Légende facultative (par ex. \"Groupe WhatsApp des voyageurs\")."
                    }
                  }
                },
                "pt": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Légende facultative (par ex. \"Groupe WhatsApp des voyageurs\")."
                    }
                  }
                },
                "de": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Légende facultative (par ex. \"Groupe WhatsApp des voyageurs\")."
                    }
                  }
                },
                "es": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Légende facultative (par ex. \"Groupe WhatsApp des voyageurs\")."
                    }
                  }
                },
                "gr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Légende facultative (par ex. \"Groupe WhatsApp des voyageurs\")."
                    }
                  }
                },
                "ro": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Légende facultative (par ex. \"Groupe WhatsApp des voyageurs\")."
                    }
                  }
                }
              },
              "required": [
                "type",
                "value"
              ]
            },
            "description": "Canaux de contact publics du Beth Habad (téléphone/email/WhatsApp général, groupe WhatsApp des voyageurs, etc.)."
          },
          "activitySlides": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "image": {
                  "type": "string",
                  "description": "Image d’arrière-plan de la diapositive (obligatoire). Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
                },
                "eyebrow_icon": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
                    },
                    "source": {
                      "type": "string",
                      "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
                    }
                  },
                  "description": "Petite icône affichée à côté du texte introductif."
                },
                "eyebrow": {
                  "type": "string",
                  "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                },
                "title": {
                  "type": "string",
                  "description": "Titre principal de la diapositive."
                },
                "subtitle": {
                  "type": "string",
                  "description": "Ligne secondaire sous le titre."
                },
                "description": {
                  "type": "string",
                  "description": "Paragraphe descriptif plus long pour la diapositive."
                },
                "btn1_label": {
                  "type": "string",
                  "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                },
                "btn1_url": {
                  "type": "string",
                  "description": "URL cible du premier bouton."
                },
                "btn1_icon": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
                    },
                    "source": {
                      "type": "string",
                      "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
                    }
                  },
                  "description": "Icône du premier bouton."
                },
                "btn2_label": {
                  "type": "string",
                  "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                },
                "btn2_url": {
                  "type": "string",
                  "description": "URL cible du deuxième bouton."
                },
                "btn2_icon": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
                    },
                    "source": {
                      "type": "string",
                      "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
                    }
                  },
                  "description": "Icône du deuxième bouton."
                },
                "fr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "en": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "he": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "it": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "ru": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "pt": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "de": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "es": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "gr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                },
                "ro": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    }
                  }
                }
              },
              "required": [
                "image"
              ]
            },
            "description": "Diapositives présentant les activités du Beth Habad (même structure que les diapositives de la bannière principale)."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "about": {
                "type": "string",
                "description": "Texte de présentation du Beth Habad, au format HTML."
              }
            }
          },
          "en": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "about": {
                "type": "string",
                "description": "Texte de présentation du Beth Habad, au format HTML."
              }
            }
          },
          "he": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "about": {
                "type": "string",
                "description": "Texte de présentation du Beth Habad, au format HTML."
              }
            }
          },
          "it": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "about": {
                "type": "string",
                "description": "Texte de présentation du Beth Habad, au format HTML."
              }
            }
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "about": {
                "type": "string",
                "description": "Texte de présentation du Beth Habad, au format HTML."
              }
            }
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "about": {
                "type": "string",
                "description": "Texte de présentation du Beth Habad, au format HTML."
              }
            }
          },
          "de": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "about": {
                "type": "string",
                "description": "Texte de présentation du Beth Habad, au format HTML."
              }
            }
          },
          "es": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "about": {
                "type": "string",
                "description": "Texte de présentation du Beth Habad, au format HTML."
              }
            }
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "about": {
                "type": "string",
                "description": "Texte de présentation du Beth Habad, au format HTML."
              }
            }
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "about": {
                "type": "string",
                "description": "Texte de présentation du Beth Habad, au format HTML."
              }
            }
          }
        },
        "description": "Informations sur le Beth Habad local : texte de présentation, membres de l’équipe, canaux de contact publics et diapositives d’activités."
      },
      "TravelConfigServices": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "icon": {
              "type": "object",
              "properties": {
                "name": {
                  "type": "string",
                  "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
                },
                "source": {
                  "type": "string",
                  "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
                }
              },
              "description": "Icône de la vignette de service."
            },
            "label": {
              "type": "string",
              "description": "Nom du service (par ex. \"Mikvé\")."
            },
            "ctaLabel": {
              "type": "string",
              "description": "Libellé de bouton facultatif pour la vignette (par ex. \"En savoir plus\")."
            },
            "url": {
              "type": "string",
              "description": "Lien facultatif associé à la vignette (chemin interne ou URL complète)."
            },
            "active": {
              "type": "boolean",
              "description": "Indique si le service est affiché (true par défaut)."
            },
            "fr": {
              "type": "object",
              "nullable": true,
              "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
              "properties": {
                "label": {
                  "type": "string",
                  "description": "Nom du service (par ex. \"Mikvé\")."
                },
                "ctaLabel": {
                  "type": "string",
                  "description": "Libellé de bouton facultatif pour la vignette (par ex. \"En savoir plus\")."
                }
              }
            },
            "en": {
              "type": "object",
              "nullable": true,
              "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
              "properties": {
                "label": {
                  "type": "string",
                  "description": "Nom du service (par ex. \"Mikvé\")."
                },
                "ctaLabel": {
                  "type": "string",
                  "description": "Libellé de bouton facultatif pour la vignette (par ex. \"En savoir plus\")."
                }
              }
            },
            "he": {
              "type": "object",
              "nullable": true,
              "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
              "properties": {
                "label": {
                  "type": "string",
                  "description": "Nom du service (par ex. \"Mikvé\")."
                },
                "ctaLabel": {
                  "type": "string",
                  "description": "Libellé de bouton facultatif pour la vignette (par ex. \"En savoir plus\")."
                }
              }
            },
            "it": {
              "type": "object",
              "nullable": true,
              "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
              "properties": {
                "label": {
                  "type": "string",
                  "description": "Nom du service (par ex. \"Mikvé\")."
                },
                "ctaLabel": {
                  "type": "string",
                  "description": "Libellé de bouton facultatif pour la vignette (par ex. \"En savoir plus\")."
                }
              }
            },
            "ru": {
              "type": "object",
              "nullable": true,
              "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
              "properties": {
                "label": {
                  "type": "string",
                  "description": "Nom du service (par ex. \"Mikvé\")."
                },
                "ctaLabel": {
                  "type": "string",
                  "description": "Libellé de bouton facultatif pour la vignette (par ex. \"En savoir plus\")."
                }
              }
            },
            "pt": {
              "type": "object",
              "nullable": true,
              "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
              "properties": {
                "label": {
                  "type": "string",
                  "description": "Nom du service (par ex. \"Mikvé\")."
                },
                "ctaLabel": {
                  "type": "string",
                  "description": "Libellé de bouton facultatif pour la vignette (par ex. \"En savoir plus\")."
                }
              }
            },
            "de": {
              "type": "object",
              "nullable": true,
              "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
              "properties": {
                "label": {
                  "type": "string",
                  "description": "Nom du service (par ex. \"Mikvé\")."
                },
                "ctaLabel": {
                  "type": "string",
                  "description": "Libellé de bouton facultatif pour la vignette (par ex. \"En savoir plus\")."
                }
              }
            },
            "es": {
              "type": "object",
              "nullable": true,
              "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
              "properties": {
                "label": {
                  "type": "string",
                  "description": "Nom du service (par ex. \"Mikvé\")."
                },
                "ctaLabel": {
                  "type": "string",
                  "description": "Libellé de bouton facultatif pour la vignette (par ex. \"En savoir plus\")."
                }
              }
            },
            "gr": {
              "type": "object",
              "nullable": true,
              "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
              "properties": {
                "label": {
                  "type": "string",
                  "description": "Nom du service (par ex. \"Mikvé\")."
                },
                "ctaLabel": {
                  "type": "string",
                  "description": "Libellé de bouton facultatif pour la vignette (par ex. \"En savoir plus\")."
                }
              }
            },
            "ro": {
              "type": "object",
              "nullable": true,
              "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
              "properties": {
                "label": {
                  "type": "string",
                  "description": "Nom du service (par ex. \"Mikvé\")."
                },
                "ctaLabel": {
                  "type": "string",
                  "description": "Libellé de bouton facultatif pour la vignette (par ex. \"En savoir plus\")."
                }
              }
            }
          },
          "required": [
            "label"
          ]
        },
        "description": "Services communautaires affichés sous forme de vignettes sur la page d’accueil (par ex. \"Mikvé\", \"Minyanim\", \"Repas de Shabbat\"). Toute la section est un tableau ; vide = section masquée. Pour la modifier via l’opération PATCH de section, envoyez le tableau complet."
      },
      "TravelConfigFaq": {
        "type": "object",
        "properties": {
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "label": {
                  "type": "string",
                  "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                },
                "fr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                },
                "en": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                },
                "he": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                },
                "it": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                },
                "ru": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                },
                "pt": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                },
                "de": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                },
                "es": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                },
                "gr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                },
                "ro": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                }
              },
              "required": [
                "label"
              ]
            },
            "description": "Catégories FAQ facultatives servant à regrouper les questions."
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "categoryId": {
                  "type": "string",
                  "description": "Identifiant d’une des `categories` FAQ (facultatif)."
                },
                "question": {
                  "type": "string",
                  "description": "Question (affichée comme en-tête de l’accordéon)."
                },
                "answer": {
                  "type": "string",
                  "description": "Réponse (affichée lorsque l’entrée est développée)."
                },
                "links": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "label": {
                        "type": "string",
                        "description": "Libellé du lien."
                      },
                      "url": {
                        "type": "string",
                        "description": "URL du lien (peut pointer vers la page correspondante dans une autre langue)."
                      },
                      "fr": {
                        "type": "object",
                        "nullable": true,
                        "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                        "properties": {
                          "label": {
                            "type": "string",
                            "description": "Libellé du lien."
                          },
                          "url": {
                            "type": "string",
                            "description": "URL du lien (peut pointer vers la page correspondante dans une autre langue)."
                          }
                        }
                      },
                      "en": {
                        "type": "object",
                        "nullable": true,
                        "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                        "properties": {
                          "label": {
                            "type": "string",
                            "description": "Libellé du lien."
                          },
                          "url": {
                            "type": "string",
                            "description": "URL du lien (peut pointer vers la page correspondante dans une autre langue)."
                          }
                        }
                      },
                      "he": {
                        "type": "object",
                        "nullable": true,
                        "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                        "properties": {
                          "label": {
                            "type": "string",
                            "description": "Libellé du lien."
                          },
                          "url": {
                            "type": "string",
                            "description": "URL du lien (peut pointer vers la page correspondante dans une autre langue)."
                          }
                        }
                      },
                      "it": {
                        "type": "object",
                        "nullable": true,
                        "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                        "properties": {
                          "label": {
                            "type": "string",
                            "description": "Libellé du lien."
                          },
                          "url": {
                            "type": "string",
                            "description": "URL du lien (peut pointer vers la page correspondante dans une autre langue)."
                          }
                        }
                      },
                      "ru": {
                        "type": "object",
                        "nullable": true,
                        "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                        "properties": {
                          "label": {
                            "type": "string",
                            "description": "Libellé du lien."
                          },
                          "url": {
                            "type": "string",
                            "description": "URL du lien (peut pointer vers la page correspondante dans une autre langue)."
                          }
                        }
                      },
                      "pt": {
                        "type": "object",
                        "nullable": true,
                        "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                        "properties": {
                          "label": {
                            "type": "string",
                            "description": "Libellé du lien."
                          },
                          "url": {
                            "type": "string",
                            "description": "URL du lien (peut pointer vers la page correspondante dans une autre langue)."
                          }
                        }
                      },
                      "de": {
                        "type": "object",
                        "nullable": true,
                        "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                        "properties": {
                          "label": {
                            "type": "string",
                            "description": "Libellé du lien."
                          },
                          "url": {
                            "type": "string",
                            "description": "URL du lien (peut pointer vers la page correspondante dans une autre langue)."
                          }
                        }
                      },
                      "es": {
                        "type": "object",
                        "nullable": true,
                        "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                        "properties": {
                          "label": {
                            "type": "string",
                            "description": "Libellé du lien."
                          },
                          "url": {
                            "type": "string",
                            "description": "URL du lien (peut pointer vers la page correspondante dans une autre langue)."
                          }
                        }
                      },
                      "gr": {
                        "type": "object",
                        "nullable": true,
                        "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                        "properties": {
                          "label": {
                            "type": "string",
                            "description": "Libellé du lien."
                          },
                          "url": {
                            "type": "string",
                            "description": "URL du lien (peut pointer vers la page correspondante dans une autre langue)."
                          }
                        }
                      },
                      "ro": {
                        "type": "object",
                        "nullable": true,
                        "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                        "properties": {
                          "label": {
                            "type": "string",
                            "description": "Libellé du lien."
                          },
                          "url": {
                            "type": "string",
                            "description": "URL du lien (peut pointer vers la page correspondante dans une autre langue)."
                          }
                        }
                      }
                    },
                    "required": [
                      "label",
                      "url"
                    ]
                  },
                  "description": "Liste facultative de liens utiles affichés avec la réponse."
                },
                "fr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "question": {
                      "type": "string",
                      "description": "Question (affichée comme en-tête de l’accordéon)."
                    },
                    "answer": {
                      "type": "string",
                      "description": "Réponse (affichée lorsque l’entrée est développée)."
                    }
                  }
                },
                "en": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "question": {
                      "type": "string",
                      "description": "Question (affichée comme en-tête de l’accordéon)."
                    },
                    "answer": {
                      "type": "string",
                      "description": "Réponse (affichée lorsque l’entrée est développée)."
                    }
                  }
                },
                "he": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "question": {
                      "type": "string",
                      "description": "Question (affichée comme en-tête de l’accordéon)."
                    },
                    "answer": {
                      "type": "string",
                      "description": "Réponse (affichée lorsque l’entrée est développée)."
                    }
                  }
                },
                "it": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "question": {
                      "type": "string",
                      "description": "Question (affichée comme en-tête de l’accordéon)."
                    },
                    "answer": {
                      "type": "string",
                      "description": "Réponse (affichée lorsque l’entrée est développée)."
                    }
                  }
                },
                "ru": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "question": {
                      "type": "string",
                      "description": "Question (affichée comme en-tête de l’accordéon)."
                    },
                    "answer": {
                      "type": "string",
                      "description": "Réponse (affichée lorsque l’entrée est développée)."
                    }
                  }
                },
                "pt": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "question": {
                      "type": "string",
                      "description": "Question (affichée comme en-tête de l’accordéon)."
                    },
                    "answer": {
                      "type": "string",
                      "description": "Réponse (affichée lorsque l’entrée est développée)."
                    }
                  }
                },
                "de": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "question": {
                      "type": "string",
                      "description": "Question (affichée comme en-tête de l’accordéon)."
                    },
                    "answer": {
                      "type": "string",
                      "description": "Réponse (affichée lorsque l’entrée est développée)."
                    }
                  }
                },
                "es": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "question": {
                      "type": "string",
                      "description": "Question (affichée comme en-tête de l’accordéon)."
                    },
                    "answer": {
                      "type": "string",
                      "description": "Réponse (affichée lorsque l’entrée est développée)."
                    }
                  }
                },
                "gr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "question": {
                      "type": "string",
                      "description": "Question (affichée comme en-tête de l’accordéon)."
                    },
                    "answer": {
                      "type": "string",
                      "description": "Réponse (affichée lorsque l’entrée est développée)."
                    }
                  }
                },
                "ro": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "question": {
                      "type": "string",
                      "description": "Question (affichée comme en-tête de l’accordéon)."
                    },
                    "answer": {
                      "type": "string",
                      "description": "Réponse (affichée lorsque l’entrée est développée)."
                    }
                  }
                }
              },
              "required": [
                "question",
                "answer"
              ]
            },
            "description": "Entrées FAQ (question/réponse), chacune pouvant être associée à une catégorie."
          },
          "lastUpdatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true,
            "description": "Horodatage de la dernière modification des FAQ, défini automatiquement par le serveur à chaque écriture."
          }
        },
        "description": "Questions fréquentes du site, éventuellement regroupées par catégories."
      },
      "TravelConfigJourney": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Indique si la carte « Annoncer ma visite » est affichée sur la page d’accueil."
          },
          "seasons": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "label": {
                  "type": "string",
                  "description": "Nom de la saison (par ex. \"Été 2026\")."
                },
                "startDate": {
                  "type": "string",
                  "format": "date-time",
                  "description": "Date de début de la saison (ISO 8601)."
                },
                "endDate": {
                  "type": "string",
                  "format": "date-time",
                  "description": "Date de fin de la saison (ISO 8601)."
                },
                "color": {
                  "type": "string",
                  "description": "Couleur hexadécimale utilisée pour identifier la saison dans l’admin."
                }
              },
              "required": [
                "label",
                "startDate",
                "endDate"
              ]
            },
            "description": "Saisons touristiques utilisées UNIQUEMENT pour regrouper dans l’admin les demandes d’annonce de voyage (elles ne sont jamais visibles par les visiteurs). Une demande entrante est automatiquement associée à la saison dont la plage de dates contient le séjour."
          }
        },
        "description": "Fonctionnalité « annoncer ma visite » : carte permettant aux touristes d’informer le Beth Habad de leur venue, ainsi que les saisons touristiques réservées à l’admin."
      },
      "TravelConfigChatbot": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Indique si le chatbot est actif sur le site."
          },
          "welcomeMessage": {
            "type": "string",
            "description": "Message de bienvenue affiché au visiteur à l’ouverture du chat (facultatif)."
          }
        },
        "description": "Assistant touristique IA du site. Seuls le réglage d’activation public et le message de bienvenue sont exposés ici — les instructions de comportement du LLM et le contexte complémentaire (customInstructions/extraContext) sont réservés au tableau de bord et ne peuvent pas être lus ou modifiés via l’API."
      },
      "TravelConfigBookingApi": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Indique si les hôtels importés depuis Booking.com sont affichés sur le site."
          },
          "affiliateId": {
            "type": "string",
            "description": "Identifiant affilié Booking.com facultatif, inséré dans les liens vers les hôtels pour générer une commission."
          },
          "categoryId": {
            "type": "string",
            "description": "Catégorie d’hôtel par défaut (issue de config.hotel.categories) attribuée aux hôtels importés."
          }
        },
        "description": "Paramètres d’intégration Booking.com. La clé RapidAPI reste côté serveur et n’est jamais exposée ; seuls les paramètres d’affichage publics sont accessibles ici. Les hôtels importés apparaissent comme entrées BookingPlace en lecture seule."
      },
      "TravelConfigAirbnbApi": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Indique si les annonces importées depuis Airbnb sont affichées sur le site."
          },
          "categoryId": {
            "type": "string",
            "description": "Catégorie par défaut attribuée aux annonces Airbnb importées."
          }
        },
        "description": "Paramètres d’intégration Airbnb (options d’affichage uniquement ; la clé fournisseur reste côté serveur). Les annonces importées apparaissent comme entrées AirbnbPlace en lecture seule."
      },
      "TravelConfig": {
        "type": "object",
        "properties": {
          "chabbat": {
            "$ref": "#/components/schemas/TravelConfigChabbat"
          },
          "theme": {
            "$ref": "#/components/schemas/TravelConfigTheme"
          },
          "jewishInfo": {
            "$ref": "#/components/schemas/TravelConfigJewishInfo"
          },
          "horaires": {
            "$ref": "#/components/schemas/TravelConfigHoraires"
          },
          "menu": {
            "$ref": "#/components/schemas/TravelConfigMenu"
          },
          "heroBanner": {
            "$ref": "#/components/schemas/TravelConfigHeroBanner"
          },
          "homepage": {
            "$ref": "#/components/schemas/TravelConfigHomepage"
          },
          "bethHabad": {
            "$ref": "#/components/schemas/TravelConfigBethHabad"
          },
          "services": {
            "$ref": "#/components/schemas/TravelConfigServices"
          },
          "faq": {
            "$ref": "#/components/schemas/TravelConfigFaq"
          },
          "journey": {
            "$ref": "#/components/schemas/TravelConfigJourney"
          },
          "chatbot": {
            "$ref": "#/components/schemas/TravelConfigChatbot"
          },
          "bookingApi": {
            "$ref": "#/components/schemas/TravelConfigBookingApi"
          },
          "airbnbApi": {
            "$ref": "#/components/schemas/TravelConfigAirbnbApi"
          },
          "kosher": {
            "type": "object",
            "properties": {
              "categories": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    },
                    "fr": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "en": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "he": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "it": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "ru": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "pt": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "de": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "es": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "gr": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "ro": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    }
                  },
                  "required": [
                    "label"
                  ]
                }
              }
            },
            "description": "Catégories de lieux casher (par ex. \"Restaurant\", \"Boulangerie\", \"Épicerie\")."
          },
          "hotel": {
            "type": "object",
            "properties": {
              "categories": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    },
                    "fr": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "en": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "he": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "it": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "ru": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "pt": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "de": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "es": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "gr": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "ro": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    }
                  },
                  "required": [
                    "label"
                  ]
                }
              }
            },
            "description": "Catégories d’hébergements (par ex. \"Hôtel\", \"Maison d’hôtes\", \"Appartement\")."
          },
          "attraction": {
            "type": "object",
            "properties": {
              "categories": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    },
                    "fr": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "en": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "he": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "it": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "ru": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "pt": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "de": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "es": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "gr": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    },
                    "ro": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                        }
                      }
                    }
                  },
                  "required": [
                    "label"
                  ]
                }
              }
            },
            "description": "Catégories d’attractions (par ex. \"Musée\", \"Plage\", \"Parc\")."
          },
          "bethHabadLabel": {
            "type": "string"
          },
          "siteId": {
            "type": "string"
          }
        }
      },
      "KosherPlace": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string",
            "description": "Nom affiché du lieu (par ex. \"Chez David\", \"Restaurant HaMakor\")."
          },
          "categoryId": {
            "type": "string",
            "description": "Identifiant d’une catégorie de config.kosher.categories (par ex. \"Restaurant\", \"Boulangerie\"). Facultatif ; les catégories se gèrent via PATCH /config/categories/kosher."
          },
          "image": {
            "type": "string",
            "description": "Image principale/de couverture du lieu. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
          },
          "images": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
            },
            "description": "Images supplémentaires de la galerie (en plus de l’image de couverture principale)."
          },
          "address": {
            "type": "object",
            "properties": {
              "address": {
                "type": "string",
                "description": "Adresse postale complète sur une seule ligne (rue, ville, pays)."
              },
              "lat": {
                "type": "number",
                "description": "Latitude (degrés décimaux)."
              },
              "lon": {
                "type": "number",
                "description": "Longitude (degrés décimaux)."
              }
            },
            "description": "Adresse postale géocodée. `address` est l’adresse complète sur une ligne ; `lat`/`lon` sont ses coordonnées (utilisées pour la carte et le bouton de navigation). Dans l’admin, ces valeurs proviennent de l’autocomplétion d’adresse (Photon/komoot) — lors d’une écriture via l’API, fournissez l’adresse complète et, si possible, lat/lon."
          },
          "kashrut": {
            "type": "string",
            "description": "Autorité de certification casher, en texte libre (par ex. \"Rav Machluf\", \"Beth Din de Paris\", \"Mehadrin\"). PAS une énumération — recopiez le nom de l’organisme de supervision tel qu’il est écrit."
          },
          "kashrutComment": {
            "type": "string",
            "description": "Note en texte libre sur la certification (par ex. \"Toute la viande provient d’une shehita Loubavitch\")."
          },
          "meatType": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "meat",
                "dairy",
                "parve",
                "fish"
              ]
            },
            "description": "Catégories alimentaires de cacherout affichées comme étiquettes colorées : \"meat\" (basari), \"dairy\" (halavi), \"parve\" (neutre). \"fish\" est accepté mais rarement utilisé (l’interface admin ne propose que meat/dairy/parve)."
          },
          "comment": {
            "type": "string",
            "description": "Description détaillée du lieu en texte libre, au format HTML (paragraphes, gras, liens). Affichée comme contenu principal de la page de détail."
          },
          "orderUrl": {
            "type": "string",
            "description": "Lien externe pour commander en ligne ou vers le site du lieu. Affiché sous forme de bouton d’action « Site web »."
          },
          "menuImages": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
            },
            "description": "Photos du menu, affichées dans une galerie sur la page de détail."
          },
          "menuPdf": {
            "type": "string",
            "description": "Nom de fichier hébergé du menu au format PDF (\"md5.pdf\"). Affiché sous forme de bouton d’action « Voir le menu »."
          },
          "contacts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "phone",
                    "email",
                    "whatsapp"
                  ],
                  "description": "Type de contact : \"phone\", \"email\" ou \"whatsapp\"."
                },
                "value": {
                  "type": "string",
                  "description": "Numéro de téléphone, adresse email ou numéro WhatsApp (format E.164 recommandé pour les numéros de téléphone/WhatsApp)."
                },
                "label": {
                  "type": "string",
                  "description": "Légende facultative affichée à côté du contact (par ex. \"Réservations\", \"Urgences\")."
                }
              },
              "required": [
                "type",
                "value"
              ],
              "description": "Mode de contact. `value` contient le numéro de téléphone/l’email/le numéro WhatsApp selon `type`. Affiché comme bouton d’action pour appeler/envoyer un email/ouvrir WhatsApp."
            }
          },
          "hours": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "open": {
                    "type": "string"
                  },
                  "close": {
                    "type": "string"
                  }
                }
              }
            },
            "description": "Horaires d’ouverture : objet indexé par jour en anglais minuscule (\"sunday\"…\"saturday\"), dont la valeur est un tableau de plages {open, close} au format \"HH:mm\" (24 h). Plusieurs plages par jour permettent de séparer les horaires (par ex. déjeuner + dîner). Un tableau vide (ou l’absence de clé pour le jour) signifie que le lieu est fermé ce jour-là. Les lieux casher omettent généralement \"saturday\" (Shabbat) ; les attractions peuvent l’inclure."
          },
          "note": {
            "type": "number",
            "description": "Note attribuée par le Beth Habad au lieu, de 0 à 5 (demi-points autorisés, par ex. 4.5). Affichée sous forme d’étoiles ; masquée lorsque la note vaut 0 ou est absente. Il s’agit d’une évaluation éditoriale de l’organisation, pas d’une moyenne d’avis publics."
          },
          "position": {
            "type": "number",
            "description": "Ordre de tri dans la liste (croissant). Généralement défini via l’opération de réorganisation, pas manuellement."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu (par ex. \"Chez David\", \"Restaurant HaMakor\")."
              },
              "kashrutComment": {
                "type": "string",
                "description": "Note en texte libre sur la certification (par ex. \"Toute la viande provient d’une shehita Loubavitch\")."
              },
              "comment": {
                "type": "string",
                "description": "Description détaillée du lieu en texte libre, au format HTML (paragraphes, gras, liens). Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "en": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu (par ex. \"Chez David\", \"Restaurant HaMakor\")."
              },
              "kashrutComment": {
                "type": "string",
                "description": "Note en texte libre sur la certification (par ex. \"Toute la viande provient d’une shehita Loubavitch\")."
              },
              "comment": {
                "type": "string",
                "description": "Description détaillée du lieu en texte libre, au format HTML (paragraphes, gras, liens). Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "he": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu (par ex. \"Chez David\", \"Restaurant HaMakor\")."
              },
              "kashrutComment": {
                "type": "string",
                "description": "Note en texte libre sur la certification (par ex. \"Toute la viande provient d’une shehita Loubavitch\")."
              },
              "comment": {
                "type": "string",
                "description": "Description détaillée du lieu en texte libre, au format HTML (paragraphes, gras, liens). Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "it": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu (par ex. \"Chez David\", \"Restaurant HaMakor\")."
              },
              "kashrutComment": {
                "type": "string",
                "description": "Note en texte libre sur la certification (par ex. \"Toute la viande provient d’une shehita Loubavitch\")."
              },
              "comment": {
                "type": "string",
                "description": "Description détaillée du lieu en texte libre, au format HTML (paragraphes, gras, liens). Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu (par ex. \"Chez David\", \"Restaurant HaMakor\")."
              },
              "kashrutComment": {
                "type": "string",
                "description": "Note en texte libre sur la certification (par ex. \"Toute la viande provient d’une shehita Loubavitch\")."
              },
              "comment": {
                "type": "string",
                "description": "Description détaillée du lieu en texte libre, au format HTML (paragraphes, gras, liens). Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu (par ex. \"Chez David\", \"Restaurant HaMakor\")."
              },
              "kashrutComment": {
                "type": "string",
                "description": "Note en texte libre sur la certification (par ex. \"Toute la viande provient d’une shehita Loubavitch\")."
              },
              "comment": {
                "type": "string",
                "description": "Description détaillée du lieu en texte libre, au format HTML (paragraphes, gras, liens). Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "de": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu (par ex. \"Chez David\", \"Restaurant HaMakor\")."
              },
              "kashrutComment": {
                "type": "string",
                "description": "Note en texte libre sur la certification (par ex. \"Toute la viande provient d’une shehita Loubavitch\")."
              },
              "comment": {
                "type": "string",
                "description": "Description détaillée du lieu en texte libre, au format HTML (paragraphes, gras, liens). Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "es": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu (par ex. \"Chez David\", \"Restaurant HaMakor\")."
              },
              "kashrutComment": {
                "type": "string",
                "description": "Note en texte libre sur la certification (par ex. \"Toute la viande provient d’une shehita Loubavitch\")."
              },
              "comment": {
                "type": "string",
                "description": "Description détaillée du lieu en texte libre, au format HTML (paragraphes, gras, liens). Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu (par ex. \"Chez David\", \"Restaurant HaMakor\")."
              },
              "kashrutComment": {
                "type": "string",
                "description": "Note en texte libre sur la certification (par ex. \"Toute la viande provient d’une shehita Loubavitch\")."
              },
              "comment": {
                "type": "string",
                "description": "Description détaillée du lieu en texte libre, au format HTML (paragraphes, gras, liens). Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu (par ex. \"Chez David\", \"Restaurant HaMakor\")."
              },
              "kashrutComment": {
                "type": "string",
                "description": "Note en texte libre sur la certification (par ex. \"Toute la viande provient d’une shehita Loubavitch\")."
              },
              "comment": {
                "type": "string",
                "description": "Description détaillée du lieu en texte libre, au format HTML (paragraphes, gras, liens). Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "urlPath": {
            "type": "string",
            "readOnly": true,
            "description": "URL relative de la page publique de cet élément sur le site (par ex. `/travel/kosher-places/<id>`). Présente pour les lieux casher/hôtels/attractions. Calculée à la lecture ; ajoutez le domaine du site (et la langue) pour obtenir le lien complet."
          }
        },
        "description": "Lieu de restauration casher répertorié sur le site touristique (restaurant, traiteur, boulangerie, épicerie…). Stocké dans sa propre collection pour la recherche géographique. Affiché sur la carte et la liste « Lieux casher » du site, avec sa propre page de détail.",
        "required": [
          "name",
          "image",
          "address"
        ]
      },
      "HotelPlace": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string",
            "description": "Nom affiché de l’hébergement (par ex. \"Hôtel David\", \"Résidence HaMakor\")."
          },
          "categoryId": {
            "type": "string",
            "description": "Identifiant d’une catégorie de config.hotel.categories. Facultatif ; les catégories se gèrent via PATCH /config/categories/hotel."
          },
          "isKosher": {
            "type": "boolean",
            "description": "Indique si l’hébergement est casher (par ex. cuisine casher / adapté au Shabbat). Affiché avec une étiquette verte « Casher »."
          },
          "images": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
            },
            "description": "Galerie photo facultative. Un hôtel ne possède PAS de champ `image` unique — l’image de couverture est `thumbnail`, choisie dans cette galerie. Omettez ce champ ou laissez-le vide si aucune photo source n’est disponible ; le site affiche alors son image par défaut."
          },
          "thumbnail": {
            "type": "string",
            "description": "Image de `images` utilisée comme couverture/visuel principal. Si elle est absente, la première image de la galerie est utilisée. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
          },
          "address": {
            "type": "object",
            "properties": {
              "address": {
                "type": "string",
                "description": "Adresse postale complète sur une seule ligne (rue, ville, pays)."
              },
              "lat": {
                "type": "number",
                "description": "Latitude (degrés décimaux)."
              },
              "lon": {
                "type": "number",
                "description": "Longitude (degrés décimaux)."
              }
            },
            "description": "Adresse postale géocodée. `address` est l’adresse complète sur une ligne ; `lat`/`lon` sont ses coordonnées (utilisées pour la carte et le bouton de navigation). Dans l’admin, ces valeurs proviennent de l’autocomplétion d’adresse (Photon/komoot) — lors d’une écriture via l’API, fournissez l’adresse complète et, si possible, lat/lon."
          },
          "description": {
            "type": "string",
            "description": "Description détaillée de l’hébergement en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
          },
          "bookingUrl": {
            "type": "string",
            "description": "Lien externe pour réserver en ligne. Affiché sous forme de bouton d’action « Réserver »."
          },
          "note": {
            "type": "number",
            "description": "Note éditoriale attribuée par le Beth Habad, de 0 à 5 (demi-points autorisés). Affichée sous forme d’étoiles ; masquée lorsque la valeur est 0/absente. Même sens que `note` d’un lieu casher — PAS le classement officiel en étoiles de l’hôtel (champ `stars`) ni une moyenne d’avis publics (champ `rating`)."
          },
          "stars": {
            "type": "number",
            "description": "Classement officiel de l’hôtel en étoiles (1–5), au sens hôtelier. Utilisé dans les métadonnées SEO de la page. Non modifiable depuis le formulaire admin standard — généralement défini par importation ou via l’API."
          },
          "rating": {
            "type": "number",
            "description": "Note moyenne des avis de voyageurs (par ex. issue d’une annonce Booking/Airbnb importée). À distinguer de `note` (évaluation de l’organisation). Non définie par le formulaire admin manuel."
          },
          "contacts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "phone",
                    "email",
                    "whatsapp"
                  ],
                  "description": "Type de contact : \"phone\", \"email\" ou \"whatsapp\"."
                },
                "value": {
                  "type": "string",
                  "description": "Numéro de téléphone, adresse email ou numéro WhatsApp (format E.164 recommandé pour les numéros de téléphone/WhatsApp)."
                },
                "label": {
                  "type": "string",
                  "description": "Légende facultative affichée à côté du contact (par ex. \"Réservations\", \"Urgences\")."
                }
              },
              "required": [
                "type",
                "value"
              ],
              "description": "Mode de contact. `value` contient le numéro de téléphone/l’email/le numéro WhatsApp selon `type`. Affiché comme bouton d’action pour appeler/envoyer un email/ouvrir WhatsApp."
            }
          },
          "position": {
            "type": "number",
            "description": "Ordre de tri dans la liste (croissant). Généralement défini via l’opération de réorganisation."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’hébergement (par ex. \"Hôtel David\", \"Résidence HaMakor\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’hébergement en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "en": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’hébergement (par ex. \"Hôtel David\", \"Résidence HaMakor\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’hébergement en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "he": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’hébergement (par ex. \"Hôtel David\", \"Résidence HaMakor\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’hébergement en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "it": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’hébergement (par ex. \"Hôtel David\", \"Résidence HaMakor\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’hébergement en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’hébergement (par ex. \"Hôtel David\", \"Résidence HaMakor\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’hébergement en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’hébergement (par ex. \"Hôtel David\", \"Résidence HaMakor\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’hébergement en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "de": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’hébergement (par ex. \"Hôtel David\", \"Résidence HaMakor\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’hébergement en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "es": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’hébergement (par ex. \"Hôtel David\", \"Résidence HaMakor\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’hébergement en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’hébergement (par ex. \"Hôtel David\", \"Résidence HaMakor\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’hébergement en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’hébergement (par ex. \"Hôtel David\", \"Résidence HaMakor\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’hébergement en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              }
            }
          },
          "urlPath": {
            "type": "string",
            "readOnly": true,
            "description": "URL relative de la page publique de cet élément sur le site (par ex. `/travel/hotels/<id>`). Présente pour les lieux casher/hôtels/attractions. Calculée à la lecture ; ajoutez le domaine du site (et la langue) pour obtenir le lien complet."
          }
        },
        "description": "Hébergement répertorié sur le site touristique (hôtel, maison d’hôtes, appartement…), généralement à proximité du Beth Habad. Stocké dans sa propre collection pour la recherche géographique ; affiché sur la carte/liste « Hôtels » du site avec une page de détail. La distance à pied jusqu’au Beth Habad est calculée par le site et n’est pas enregistrée ici.",
        "required": [
          "name",
          "address"
        ]
      },
      "AttractionPlace": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string",
            "description": "Nom affiché de l’attraction (par ex. \"Musée de la ville\", \"Plage de Bocas\")."
          },
          "categoryId": {
            "type": "string",
            "description": "Identifiant d’une catégorie de config.attraction.categories. Facultatif ; les catégories se gèrent via PATCH /config/categories/attraction."
          },
          "image": {
            "type": "string",
            "description": "Image principale/de couverture facultative de l’attraction. Omettez-la si aucune photo source n’est disponible ; le site affiche alors son image par défaut. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
          },
          "address": {
            "type": "object",
            "properties": {
              "address": {
                "type": "string",
                "description": "Adresse postale complète sur une seule ligne (rue, ville, pays)."
              },
              "lat": {
                "type": "number",
                "description": "Latitude (degrés décimaux)."
              },
              "lon": {
                "type": "number",
                "description": "Longitude (degrés décimaux)."
              }
            },
            "description": "Adresse postale géocodée. `address` est l’adresse complète sur une ligne ; `lat`/`lon` sont ses coordonnées (utilisées pour la carte et le bouton de navigation). Dans l’admin, ces valeurs proviennent de l’autocomplétion d’adresse (Photon/komoot) — lors d’une écriture via l’API, fournissez l’adresse complète et, si possible, lat/lon."
          },
          "description": {
            "type": "string",
            "description": "Description détaillée de l’attraction en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
          },
          "price": {
            "type": "string",
            "description": "Prix d’entrée en TEXTE LIBRE, pas sous forme de nombre — il est descriptif et traduisible (par ex. \"10€ adulte, gratuit moins de 12 ans\", \"Don\"). Laissez vide si sans objet."
          },
          "website": {
            "type": "string",
            "description": "Site web externe de l’attraction. Affiché sous forme de bouton d’action « Site web »."
          },
          "note": {
            "type": "number",
            "description": "Note éditoriale du Beth Habad, de 0 à 5 (demi-points autorisés). Affichée sous forme d’étoiles ; masquée lorsque la valeur est 0/absente. Même sens que pour les lieux casher/hôtels."
          },
          "contacts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "phone",
                    "email",
                    "whatsapp"
                  ],
                  "description": "Type de contact : \"phone\", \"email\" ou \"whatsapp\"."
                },
                "value": {
                  "type": "string",
                  "description": "Numéro de téléphone, adresse email ou numéro WhatsApp (format E.164 recommandé pour les numéros de téléphone/WhatsApp)."
                },
                "label": {
                  "type": "string",
                  "description": "Légende facultative affichée à côté du contact (par ex. \"Réservations\", \"Urgences\")."
                }
              },
              "required": [
                "type",
                "value"
              ],
              "description": "Mode de contact. `value` contient le numéro de téléphone/l’email/le numéro WhatsApp selon `type`. Affiché comme bouton d’action pour appeler/envoyer un email/ouvrir WhatsApp."
            }
          },
          "hours": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "open": {
                    "type": "string"
                  },
                  "close": {
                    "type": "string"
                  }
                }
              }
            },
            "description": "Horaires d’ouverture : objet indexé par jour en anglais minuscule (\"sunday\"…\"saturday\"), dont la valeur est un tableau de plages {open, close} au format \"HH:mm\" (24 h). Plusieurs plages par jour permettent de séparer les horaires (par ex. déjeuner + dîner). Un tableau vide (ou l’absence de clé pour le jour) signifie que le lieu est fermé ce jour-là. Les lieux casher omettent généralement \"saturday\" (Shabbat) ; les attractions peuvent l’inclure."
          },
          "position": {
            "type": "number",
            "description": "Ordre de tri dans la liste (croissant). Généralement défini via l’opération de réorganisation."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’attraction (par ex. \"Musée de la ville\", \"Plage de Bocas\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’attraction en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              },
              "price": {
                "type": "string",
                "description": "Prix d’entrée en TEXTE LIBRE, pas sous forme de nombre — il est descriptif et traduisible (par ex. \"10€ adulte, gratuit moins de 12 ans\", \"Don\"). Laissez vide si sans objet."
              }
            }
          },
          "en": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’attraction (par ex. \"Musée de la ville\", \"Plage de Bocas\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’attraction en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              },
              "price": {
                "type": "string",
                "description": "Prix d’entrée en TEXTE LIBRE, pas sous forme de nombre — il est descriptif et traduisible (par ex. \"10€ adulte, gratuit moins de 12 ans\", \"Don\"). Laissez vide si sans objet."
              }
            }
          },
          "he": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’attraction (par ex. \"Musée de la ville\", \"Plage de Bocas\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’attraction en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              },
              "price": {
                "type": "string",
                "description": "Prix d’entrée en TEXTE LIBRE, pas sous forme de nombre — il est descriptif et traduisible (par ex. \"10€ adulte, gratuit moins de 12 ans\", \"Don\"). Laissez vide si sans objet."
              }
            }
          },
          "it": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’attraction (par ex. \"Musée de la ville\", \"Plage de Bocas\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’attraction en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              },
              "price": {
                "type": "string",
                "description": "Prix d’entrée en TEXTE LIBRE, pas sous forme de nombre — il est descriptif et traduisible (par ex. \"10€ adulte, gratuit moins de 12 ans\", \"Don\"). Laissez vide si sans objet."
              }
            }
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’attraction (par ex. \"Musée de la ville\", \"Plage de Bocas\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’attraction en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              },
              "price": {
                "type": "string",
                "description": "Prix d’entrée en TEXTE LIBRE, pas sous forme de nombre — il est descriptif et traduisible (par ex. \"10€ adulte, gratuit moins de 12 ans\", \"Don\"). Laissez vide si sans objet."
              }
            }
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’attraction (par ex. \"Musée de la ville\", \"Plage de Bocas\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’attraction en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              },
              "price": {
                "type": "string",
                "description": "Prix d’entrée en TEXTE LIBRE, pas sous forme de nombre — il est descriptif et traduisible (par ex. \"10€ adulte, gratuit moins de 12 ans\", \"Don\"). Laissez vide si sans objet."
              }
            }
          },
          "de": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’attraction (par ex. \"Musée de la ville\", \"Plage de Bocas\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’attraction en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              },
              "price": {
                "type": "string",
                "description": "Prix d’entrée en TEXTE LIBRE, pas sous forme de nombre — il est descriptif et traduisible (par ex. \"10€ adulte, gratuit moins de 12 ans\", \"Don\"). Laissez vide si sans objet."
              }
            }
          },
          "es": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’attraction (par ex. \"Musée de la ville\", \"Plage de Bocas\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’attraction en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              },
              "price": {
                "type": "string",
                "description": "Prix d’entrée en TEXTE LIBRE, pas sous forme de nombre — il est descriptif et traduisible (par ex. \"10€ adulte, gratuit moins de 12 ans\", \"Don\"). Laissez vide si sans objet."
              }
            }
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’attraction (par ex. \"Musée de la ville\", \"Plage de Bocas\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’attraction en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              },
              "price": {
                "type": "string",
                "description": "Prix d’entrée en TEXTE LIBRE, pas sous forme de nombre — il est descriptif et traduisible (par ex. \"10€ adulte, gratuit moins de 12 ans\", \"Don\"). Laissez vide si sans objet."
              }
            }
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché de l’attraction (par ex. \"Musée de la ville\", \"Plage de Bocas\")."
              },
              "description": {
                "type": "string",
                "description": "Description détaillée de l’attraction en texte libre, au format HTML. Affichée comme contenu principal de la page de détail."
              },
              "price": {
                "type": "string",
                "description": "Prix d’entrée en TEXTE LIBRE, pas sous forme de nombre — il est descriptif et traduisible (par ex. \"10€ adulte, gratuit moins de 12 ans\", \"Don\"). Laissez vide si sans objet."
              }
            }
          },
          "urlPath": {
            "type": "string",
            "readOnly": true,
            "description": "URL relative de la page publique de cet élément sur le site (par ex. `/travel/attractions/<id>`). Présente pour les lieux casher/hôtels/attractions. Calculée à la lecture ; ajoutez le domaine du site (et la langue) pour obtenir le lien complet."
          }
        },
        "description": "Attraction touristique ou lieu d’intérêt répertorié sur le site touristique (musée, plage, parc, monument…). Stocké dans sa propre collection pour la recherche géographique ; affiché sur la carte/liste « Attractions » du site avec une page de détail.",
        "required": [
          "name",
          "address"
        ]
      },
      "TravelSection": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "slug": {
            "type": "string",
            "description": "Slug de l’URL de la page de rubrique (/travel/c/<slug>). Laissez vide pour générer automatiquement à partir de `label` ; toute valeur fournie est normalisée (convertie en slug) et rendue unique par site. Recalculé lorsque `label`/`slug` change."
          },
          "label": {
            "type": "string",
            "description": "Nom de la rubrique affiché dans le menu et comme titre de page (par ex. \"Synagogues\", \"Pharmacies\")."
          },
          "icon": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
              },
              "source": {
                "type": "string",
                "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
              }
            },
            "description": "Icône représentant la rubrique dans le menu du site."
          },
          "description": {
            "type": "string",
            "description": "Texte d’introduction facultatif (HTML) affiché en haut de la page de rubrique."
          },
          "fields": {
            "type": "object",
            "properties": {
              "subtitle": {
                "type": "boolean",
                "description": "Activer le champ `subtitle` de l’élément (slogan court)."
              },
              "badge": {
                "type": "boolean",
                "description": "Activer le champ `badge` de l’élément (petite étiquette, par ex. \"Mehadrin\", \"24/7\")."
              },
              "longDescription": {
                "type": "boolean",
                "description": "Utiliser un éditeur HTML enrichi pour le champ `description` de l’élément (sinon, `description` est un texte brut court)."
              },
              "gallery": {
                "type": "boolean",
                "description": "Activer la galerie photo de l’élément (`images`)."
              },
              "pdf": {
                "type": "boolean",
                "description": "Activer le champ de document `pdf` de l’élément."
              },
              "video": {
                "type": "boolean",
                "description": "Activer le champ `video` de l’élément (URL YouTube)."
              },
              "website": {
                "type": "boolean",
                "description": "Activer le champ `website` de l’élément."
              },
              "actionButton": {
                "type": "boolean",
                "description": "Activer le bouton d’action personnalisé (`actionLabel` + `actionUrl`)."
              },
              "socials": {
                "type": "boolean",
                "description": "Activer le bloc `socials` de l’élément (Facebook/Instagram/YouTube/TikTok)."
              },
              "hours": {
                "type": "boolean",
                "description": "Activer les horaires d’ouverture `hours` de l’élément."
              },
              "note": {
                "type": "boolean",
                "description": "Activer la note `note` de l’élément (évaluation du Beth Habad sur 5)."
              },
              "price": {
                "type": "boolean",
                "description": "Activer le champ `price` de l’élément (texte libre)."
              }
            },
            "description": "Options par rubrique qui déterminent les champs facultatifs affichés par l’interface admin pour les lieux de cette rubrique. Le nom, l’image, la catégorie, l’adresse et les coordonnées sont toujours disponibles. REMARQUE : ces options pilotent uniquement l’interface admin — l’API accepte et renvoie tous les champs des lieux, quels que soient ces réglages. Valeurs par défaut à la création : {longDescription:true, note:true}."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "label": {
                  "type": "string",
                  "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                },
                "fr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                },
                "en": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                },
                "he": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                },
                "it": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                },
                "ru": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                },
                "pt": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                },
                "de": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                },
                "es": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                },
                "gr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                },
                "ro": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Nom de catégorie affiché comme filtre/étiquette (par ex. \"Restaurant\", \"Boulangerie\")."
                    }
                  }
                }
              },
              "required": [
                "label"
              ]
            },
            "description": "Sous-catégories facultatives servant à filtrer les éléments de la rubrique."
          },
          "active": {
            "type": "boolean",
            "description": "Indique si la rubrique est publiée sur le site."
          },
          "position": {
            "type": "number",
            "description": "Ordre de tri de la rubrique dans le menu (croissant)."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Nom de la rubrique affiché dans le menu et comme titre de page (par ex. \"Synagogues\", \"Pharmacies\")."
              },
              "description": {
                "type": "string",
                "description": "Texte d’introduction facultatif (HTML) affiché en haut de la page de rubrique."
              }
            }
          },
          "en": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Nom de la rubrique affiché dans le menu et comme titre de page (par ex. \"Synagogues\", \"Pharmacies\")."
              },
              "description": {
                "type": "string",
                "description": "Texte d’introduction facultatif (HTML) affiché en haut de la page de rubrique."
              }
            }
          },
          "he": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Nom de la rubrique affiché dans le menu et comme titre de page (par ex. \"Synagogues\", \"Pharmacies\")."
              },
              "description": {
                "type": "string",
                "description": "Texte d’introduction facultatif (HTML) affiché en haut de la page de rubrique."
              }
            }
          },
          "it": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Nom de la rubrique affiché dans le menu et comme titre de page (par ex. \"Synagogues\", \"Pharmacies\")."
              },
              "description": {
                "type": "string",
                "description": "Texte d’introduction facultatif (HTML) affiché en haut de la page de rubrique."
              }
            }
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Nom de la rubrique affiché dans le menu et comme titre de page (par ex. \"Synagogues\", \"Pharmacies\")."
              },
              "description": {
                "type": "string",
                "description": "Texte d’introduction facultatif (HTML) affiché en haut de la page de rubrique."
              }
            }
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Nom de la rubrique affiché dans le menu et comme titre de page (par ex. \"Synagogues\", \"Pharmacies\")."
              },
              "description": {
                "type": "string",
                "description": "Texte d’introduction facultatif (HTML) affiché en haut de la page de rubrique."
              }
            }
          },
          "de": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Nom de la rubrique affiché dans le menu et comme titre de page (par ex. \"Synagogues\", \"Pharmacies\")."
              },
              "description": {
                "type": "string",
                "description": "Texte d’introduction facultatif (HTML) affiché en haut de la page de rubrique."
              }
            }
          },
          "es": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Nom de la rubrique affiché dans le menu et comme titre de page (par ex. \"Synagogues\", \"Pharmacies\")."
              },
              "description": {
                "type": "string",
                "description": "Texte d’introduction facultatif (HTML) affiché en haut de la page de rubrique."
              }
            }
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Nom de la rubrique affiché dans le menu et comme titre de page (par ex. \"Synagogues\", \"Pharmacies\")."
              },
              "description": {
                "type": "string",
                "description": "Texte d’introduction facultatif (HTML) affiché en haut de la page de rubrique."
              }
            }
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Nom de la rubrique affiché dans le menu et comme titre de page (par ex. \"Synagogues\", \"Pharmacies\")."
              },
              "description": {
                "type": "string",
                "description": "Texte d’introduction facultatif (HTML) affiché en haut de la page de rubrique."
              }
            }
          },
          "urlPath": {
            "type": "string",
            "readOnly": true,
            "description": "URL relative de la page publique de cet élément sur le site (par ex. `/travel/c/<slug>`). Il s’agit de la page de la rubrique. Calculée à la lecture ; ajoutez le domaine du site (et la langue) pour obtenir le lien complet."
          },
          "itemCount": {
            "type": "integer",
            "readOnly": true,
            "description": "Nombre d’éléments (lieux) dans cette rubrique. Calculé à la lecture (opération de liste)."
          }
        },
        "description": "Rubrique personnalisée définie par le chliah sur le site touristique — liste générique de lieux qui ne relèvent pas des catégories intégrées casher/hôtels/attractions (par ex. \"Synagogues\", \"Mikvé\", \"Pharmacies\"). Chaque rubrique possède sa propre page à /travel/c/<slug> et contient une liste de lieux. Utilisez une section personnalisée si le contenu ne correspond pas à une catégorie casher/hôtel/attraction.",
        "required": [
          "label"
        ]
      },
      "TravelSectionItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string",
            "description": "Nom affiché du lieu."
          },
          "subtitle": {
            "type": "string",
            "description": "Slogan court sous le nom (par ex. \"Ouvert 7/7\"). Affiché si la rubrique active `subtitle`."
          },
          "badge": {
            "type": "string",
            "description": "Petite étiquette (par ex. \"Mehadrin\", \"24/7\", \"Nouveau\"). Affichée si la rubrique active `badge`."
          },
          "categoryId": {
            "type": "string",
            "description": "Identifiant d’une des `categories` propres à la rubrique."
          },
          "image": {
            "type": "string",
            "description": "Image principale/de couverture (facultative pour les lieux de rubrique). Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
          },
          "images": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
            },
            "description": "Galerie photo. Affichée si la rubrique active `gallery`."
          },
          "address": {
            "type": "object",
            "properties": {
              "address": {
                "type": "string",
                "description": "Adresse postale complète sur une seule ligne (rue, ville, pays)."
              },
              "lat": {
                "type": "number",
                "description": "Latitude (degrés décimaux)."
              },
              "lon": {
                "type": "number",
                "description": "Longitude (degrés décimaux)."
              }
            },
            "description": "Adresse géocodée facultative (les lieux d’une rubrique peuvent ne pas avoir d’adresse)."
          },
          "description": {
            "type": "string",
            "description": "Description du lieu. HTML si la rubrique active `longDescription`, sinon texte brut court."
          },
          "note": {
            "type": "number",
            "description": "Évaluation éditoriale du Beth Habad de 0 à 5 (demi-points). Affichée si la rubrique active `note`."
          },
          "price": {
            "type": "string",
            "description": "Prix en texte libre (par ex. \"10€\", \"Gratuit\"). Affiché si la rubrique active `price`."
          },
          "website": {
            "type": "string",
            "description": "Site web externe. Affiché si la rubrique active `website`."
          },
          "actionLabel": {
            "type": "string",
            "description": "Libellé d’un bouton d’action personnalisé (par ex. \"Réserver\", \"Prendre rendez-vous\"). Associé à `actionUrl` ; affiché si la rubrique active `actionButton`."
          },
          "actionUrl": {
            "type": "string",
            "description": "URL cible du bouton d’action personnalisé. Associée à `actionLabel`."
          },
          "socials": {
            "type": "object",
            "properties": {
              "facebook": {
                "type": "string",
                "description": "URL de la page Facebook."
              },
              "instagram": {
                "type": "string",
                "description": "URL du profil Instagram."
              },
              "youtube": {
                "type": "string",
                "description": "URL de la chaîne YouTube."
              },
              "tiktok": {
                "type": "string",
                "description": "URL du profil TikTok."
              }
            },
            "description": "Liens vers les réseaux sociaux. Affichés si la rubrique active `socials`."
          },
          "pdf": {
            "type": "string",
            "description": "Nom de fichier PDF hébergé (\"md5.pdf\"). Affiché si la rubrique active `pdf`."
          },
          "video": {
            "type": "string",
            "description": "URL de la vidéo YouTube. Affichée si la rubrique active `video`."
          },
          "contacts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "enum": [
                    "phone",
                    "email",
                    "whatsapp"
                  ],
                  "description": "Type de contact : \"phone\", \"email\" ou \"whatsapp\"."
                },
                "value": {
                  "type": "string",
                  "description": "Numéro de téléphone, adresse email ou numéro WhatsApp (format E.164 recommandé pour les numéros de téléphone/WhatsApp)."
                },
                "label": {
                  "type": "string",
                  "description": "Légende facultative affichée à côté du contact (par ex. \"Réservations\", \"Urgences\")."
                }
              },
              "required": [
                "type",
                "value"
              ],
              "description": "Mode de contact. `value` contient le numéro de téléphone/l’email/le numéro WhatsApp selon `type`. Affiché comme bouton d’action pour appeler/envoyer un email/ouvrir WhatsApp."
            }
          },
          "hours": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "open": {
                    "type": "string"
                  },
                  "close": {
                    "type": "string"
                  }
                }
              }
            },
            "description": "Horaires d’ouverture : objet indexé par jour en anglais minuscule (\"sunday\"…\"saturday\"), dont la valeur est un tableau de plages {open, close} au format \"HH:mm\" (24 h). Plusieurs plages par jour permettent de séparer les horaires (par ex. déjeuner + dîner). Un tableau vide (ou l’absence de clé pour le jour) signifie que le lieu est fermé ce jour-là. Les lieux casher omettent généralement \"saturday\" (Shabbat) ; les attractions peuvent l’inclure."
          },
          "active": {
            "type": "boolean",
            "description": "Indique si le lieu est publié."
          },
          "position": {
            "type": "number",
            "description": "Ordre de tri dans la rubrique (croissant)."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu."
              },
              "subtitle": {
                "type": "string",
                "description": "Slogan court sous le nom (par ex. \"Ouvert 7/7\"). Affiché si la rubrique active `subtitle`."
              },
              "badge": {
                "type": "string",
                "description": "Petite étiquette (par ex. \"Mehadrin\", \"24/7\", \"Nouveau\"). Affichée si la rubrique active `badge`."
              },
              "description": {
                "type": "string",
                "description": "Description du lieu. HTML si la rubrique active `longDescription`, sinon texte brut court."
              },
              "price": {
                "type": "string",
                "description": "Prix en texte libre (par ex. \"10€\", \"Gratuit\"). Affiché si la rubrique active `price`."
              },
              "actionLabel": {
                "type": "string",
                "description": "Libellé d’un bouton d’action personnalisé (par ex. \"Réserver\", \"Prendre rendez-vous\"). Associé à `actionUrl` ; affiché si la rubrique active `actionButton`."
              }
            }
          },
          "en": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu."
              },
              "subtitle": {
                "type": "string",
                "description": "Slogan court sous le nom (par ex. \"Ouvert 7/7\"). Affiché si la rubrique active `subtitle`."
              },
              "badge": {
                "type": "string",
                "description": "Petite étiquette (par ex. \"Mehadrin\", \"24/7\", \"Nouveau\"). Affichée si la rubrique active `badge`."
              },
              "description": {
                "type": "string",
                "description": "Description du lieu. HTML si la rubrique active `longDescription`, sinon texte brut court."
              },
              "price": {
                "type": "string",
                "description": "Prix en texte libre (par ex. \"10€\", \"Gratuit\"). Affiché si la rubrique active `price`."
              },
              "actionLabel": {
                "type": "string",
                "description": "Libellé d’un bouton d’action personnalisé (par ex. \"Réserver\", \"Prendre rendez-vous\"). Associé à `actionUrl` ; affiché si la rubrique active `actionButton`."
              }
            }
          },
          "he": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu."
              },
              "subtitle": {
                "type": "string",
                "description": "Slogan court sous le nom (par ex. \"Ouvert 7/7\"). Affiché si la rubrique active `subtitle`."
              },
              "badge": {
                "type": "string",
                "description": "Petite étiquette (par ex. \"Mehadrin\", \"24/7\", \"Nouveau\"). Affichée si la rubrique active `badge`."
              },
              "description": {
                "type": "string",
                "description": "Description du lieu. HTML si la rubrique active `longDescription`, sinon texte brut court."
              },
              "price": {
                "type": "string",
                "description": "Prix en texte libre (par ex. \"10€\", \"Gratuit\"). Affiché si la rubrique active `price`."
              },
              "actionLabel": {
                "type": "string",
                "description": "Libellé d’un bouton d’action personnalisé (par ex. \"Réserver\", \"Prendre rendez-vous\"). Associé à `actionUrl` ; affiché si la rubrique active `actionButton`."
              }
            }
          },
          "it": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu."
              },
              "subtitle": {
                "type": "string",
                "description": "Slogan court sous le nom (par ex. \"Ouvert 7/7\"). Affiché si la rubrique active `subtitle`."
              },
              "badge": {
                "type": "string",
                "description": "Petite étiquette (par ex. \"Mehadrin\", \"24/7\", \"Nouveau\"). Affichée si la rubrique active `badge`."
              },
              "description": {
                "type": "string",
                "description": "Description du lieu. HTML si la rubrique active `longDescription`, sinon texte brut court."
              },
              "price": {
                "type": "string",
                "description": "Prix en texte libre (par ex. \"10€\", \"Gratuit\"). Affiché si la rubrique active `price`."
              },
              "actionLabel": {
                "type": "string",
                "description": "Libellé d’un bouton d’action personnalisé (par ex. \"Réserver\", \"Prendre rendez-vous\"). Associé à `actionUrl` ; affiché si la rubrique active `actionButton`."
              }
            }
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu."
              },
              "subtitle": {
                "type": "string",
                "description": "Slogan court sous le nom (par ex. \"Ouvert 7/7\"). Affiché si la rubrique active `subtitle`."
              },
              "badge": {
                "type": "string",
                "description": "Petite étiquette (par ex. \"Mehadrin\", \"24/7\", \"Nouveau\"). Affichée si la rubrique active `badge`."
              },
              "description": {
                "type": "string",
                "description": "Description du lieu. HTML si la rubrique active `longDescription`, sinon texte brut court."
              },
              "price": {
                "type": "string",
                "description": "Prix en texte libre (par ex. \"10€\", \"Gratuit\"). Affiché si la rubrique active `price`."
              },
              "actionLabel": {
                "type": "string",
                "description": "Libellé d’un bouton d’action personnalisé (par ex. \"Réserver\", \"Prendre rendez-vous\"). Associé à `actionUrl` ; affiché si la rubrique active `actionButton`."
              }
            }
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu."
              },
              "subtitle": {
                "type": "string",
                "description": "Slogan court sous le nom (par ex. \"Ouvert 7/7\"). Affiché si la rubrique active `subtitle`."
              },
              "badge": {
                "type": "string",
                "description": "Petite étiquette (par ex. \"Mehadrin\", \"24/7\", \"Nouveau\"). Affichée si la rubrique active `badge`."
              },
              "description": {
                "type": "string",
                "description": "Description du lieu. HTML si la rubrique active `longDescription`, sinon texte brut court."
              },
              "price": {
                "type": "string",
                "description": "Prix en texte libre (par ex. \"10€\", \"Gratuit\"). Affiché si la rubrique active `price`."
              },
              "actionLabel": {
                "type": "string",
                "description": "Libellé d’un bouton d’action personnalisé (par ex. \"Réserver\", \"Prendre rendez-vous\"). Associé à `actionUrl` ; affiché si la rubrique active `actionButton`."
              }
            }
          },
          "de": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu."
              },
              "subtitle": {
                "type": "string",
                "description": "Slogan court sous le nom (par ex. \"Ouvert 7/7\"). Affiché si la rubrique active `subtitle`."
              },
              "badge": {
                "type": "string",
                "description": "Petite étiquette (par ex. \"Mehadrin\", \"24/7\", \"Nouveau\"). Affichée si la rubrique active `badge`."
              },
              "description": {
                "type": "string",
                "description": "Description du lieu. HTML si la rubrique active `longDescription`, sinon texte brut court."
              },
              "price": {
                "type": "string",
                "description": "Prix en texte libre (par ex. \"10€\", \"Gratuit\"). Affiché si la rubrique active `price`."
              },
              "actionLabel": {
                "type": "string",
                "description": "Libellé d’un bouton d’action personnalisé (par ex. \"Réserver\", \"Prendre rendez-vous\"). Associé à `actionUrl` ; affiché si la rubrique active `actionButton`."
              }
            }
          },
          "es": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu."
              },
              "subtitle": {
                "type": "string",
                "description": "Slogan court sous le nom (par ex. \"Ouvert 7/7\"). Affiché si la rubrique active `subtitle`."
              },
              "badge": {
                "type": "string",
                "description": "Petite étiquette (par ex. \"Mehadrin\", \"24/7\", \"Nouveau\"). Affichée si la rubrique active `badge`."
              },
              "description": {
                "type": "string",
                "description": "Description du lieu. HTML si la rubrique active `longDescription`, sinon texte brut court."
              },
              "price": {
                "type": "string",
                "description": "Prix en texte libre (par ex. \"10€\", \"Gratuit\"). Affiché si la rubrique active `price`."
              },
              "actionLabel": {
                "type": "string",
                "description": "Libellé d’un bouton d’action personnalisé (par ex. \"Réserver\", \"Prendre rendez-vous\"). Associé à `actionUrl` ; affiché si la rubrique active `actionButton`."
              }
            }
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu."
              },
              "subtitle": {
                "type": "string",
                "description": "Slogan court sous le nom (par ex. \"Ouvert 7/7\"). Affiché si la rubrique active `subtitle`."
              },
              "badge": {
                "type": "string",
                "description": "Petite étiquette (par ex. \"Mehadrin\", \"24/7\", \"Nouveau\"). Affichée si la rubrique active `badge`."
              },
              "description": {
                "type": "string",
                "description": "Description du lieu. HTML si la rubrique active `longDescription`, sinon texte brut court."
              },
              "price": {
                "type": "string",
                "description": "Prix en texte libre (par ex. \"10€\", \"Gratuit\"). Affiché si la rubrique active `price`."
              },
              "actionLabel": {
                "type": "string",
                "description": "Libellé d’un bouton d’action personnalisé (par ex. \"Réserver\", \"Prendre rendez-vous\"). Associé à `actionUrl` ; affiché si la rubrique active `actionButton`."
              }
            }
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom affiché du lieu."
              },
              "subtitle": {
                "type": "string",
                "description": "Slogan court sous le nom (par ex. \"Ouvert 7/7\"). Affiché si la rubrique active `subtitle`."
              },
              "badge": {
                "type": "string",
                "description": "Petite étiquette (par ex. \"Mehadrin\", \"24/7\", \"Nouveau\"). Affichée si la rubrique active `badge`."
              },
              "description": {
                "type": "string",
                "description": "Description du lieu. HTML si la rubrique active `longDescription`, sinon texte brut court."
              },
              "price": {
                "type": "string",
                "description": "Prix en texte libre (par ex. \"10€\", \"Gratuit\"). Affiché si la rubrique active `price`."
              },
              "actionLabel": {
                "type": "string",
                "description": "Libellé d’un bouton d’action personnalisé (par ex. \"Réserver\", \"Prendre rendez-vous\"). Associé à `actionUrl` ; affiché si la rubrique active `actionButton`."
              }
            }
          },
          "urlPath": {
            "type": "string",
            "readOnly": true,
            "description": "URL relative de la page publique de cet élément sur le site (par ex. `/travel/c/<slug>/<id>`). Construite à partir du slug de la rubrique parente et de l’identifiant du lieu. Calculée à la lecture ; ajoutez le domaine du site (et la langue) pour obtenir le lien complet."
          }
        },
        "description": "Lieu au sein d’une rubrique personnalisée (travel_section). Les champs visibles dans l’admin dépendent des options `fields` de la rubrique, mais l’API accepte/renvoie tous les champs. Rattaché à sa rubrique par le chemin (sectionId est imposé côté serveur). Seul `name` est obligatoire — `image` et `address` sont facultatifs ici. Les lieux intégrés d’hôtel et d’attraction autorisent également l’absence de photo, mais exigent toujours une adresse.",
        "required": [
          "name"
        ]
      },
      "BookingPlace": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "bookingId": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "images": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "thumbnail": {
            "type": "string",
            "nullable": true
          },
          "address": {
            "type": "object"
          },
          "bookingUrl": {
            "type": "string",
            "nullable": true
          },
          "rating": {
            "type": "number",
            "nullable": true
          },
          "reviewCount": {
            "type": "integer",
            "nullable": true
          },
          "stars": {
            "type": "number",
            "nullable": true
          },
          "price": {
            "type": "number",
            "nullable": true
          },
          "currency": {
            "type": "string",
            "nullable": true
          },
          "position": {
            "type": "integer"
          }
        }
      },
      "AirbnbPlace": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "airbnbId": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "images": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "thumbnail": {
            "type": "string",
            "nullable": true
          },
          "address": {
            "type": "object"
          },
          "airbnbUrl": {
            "type": "string",
            "nullable": true
          },
          "rating": {
            "type": "number",
            "nullable": true
          },
          "reviewCount": {
            "type": "integer",
            "nullable": true
          },
          "roomType": {
            "type": "string",
            "nullable": true
          },
          "personCapacity": {
            "type": "integer",
            "nullable": true
          },
          "bedrooms": {
            "type": "integer",
            "nullable": true
          },
          "bathrooms": {
            "type": "integer",
            "nullable": true
          },
          "price": {
            "type": "number",
            "nullable": true
          },
          "currency": {
            "type": "string",
            "nullable": true
          },
          "position": {
            "type": "integer"
          }
        }
      },
      "Journey": {
        "type": "object",
        "description": "Demande entrante d’annonce de voyage soumise par un touriste.",
        "properties": {
          "id": {
            "type": "string"
          },
          "travelId": {
            "type": "string"
          },
          "contactId": {
            "type": "string",
            "nullable": true
          },
          "seasonId": {
            "type": "string",
            "nullable": true
          },
          "startDate": {
            "type": "string",
            "format": "date-time"
          },
          "endDate": {
            "type": "string",
            "format": "date-time"
          },
          "adults": {
            "type": "integer"
          },
          "children": {
            "type": "integer"
          },
          "nom": {
            "type": "string"
          },
          "prenom": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "tel": {
            "type": "string"
          },
          "services": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "comment": {
            "type": "string"
          },
          "cancelled": {
            "type": "boolean"
          },
          "datetime": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "SiteSlide": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "image": {
            "type": "string",
            "description": "Image d’arrière-plan de la diapositive (obligatoire). Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
          },
          "eyebrow_icon": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
              },
              "source": {
                "type": "string",
                "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
              }
            },
            "description": "Petite icône affichée à côté du texte introductif."
          },
          "eyebrow": {
            "type": "string",
            "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
          },
          "title": {
            "type": "string",
            "description": "Titre principal de la diapositive."
          },
          "subtitle": {
            "type": "string",
            "description": "Ligne secondaire sous le titre."
          },
          "description": {
            "type": "string",
            "description": "Paragraphe descriptif plus long pour la diapositive."
          },
          "btn1_label": {
            "type": "string",
            "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
          },
          "btn1_url": {
            "type": "string",
            "description": "URL cible du premier bouton."
          },
          "btn1_icon": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
              },
              "source": {
                "type": "string",
                "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
              }
            },
            "description": "Icône du premier bouton."
          },
          "btn2_label": {
            "type": "string",
            "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
          },
          "btn2_url": {
            "type": "string",
            "description": "URL cible du deuxième bouton."
          },
          "btn2_icon": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
              },
              "source": {
                "type": "string",
                "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
              }
            },
            "description": "Icône du deuxième bouton."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Titre principal de la diapositive."
              },
              "subtitle": {
                "type": "string",
                "description": "Ligne secondaire sous le titre."
              },
              "description": {
                "type": "string",
                "description": "Paragraphe descriptif plus long pour la diapositive."
              },
              "btn1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
              }
            }
          },
          "en": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Titre principal de la diapositive."
              },
              "subtitle": {
                "type": "string",
                "description": "Ligne secondaire sous le titre."
              },
              "description": {
                "type": "string",
                "description": "Paragraphe descriptif plus long pour la diapositive."
              },
              "btn1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
              }
            }
          },
          "he": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Titre principal de la diapositive."
              },
              "subtitle": {
                "type": "string",
                "description": "Ligne secondaire sous le titre."
              },
              "description": {
                "type": "string",
                "description": "Paragraphe descriptif plus long pour la diapositive."
              },
              "btn1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
              }
            }
          },
          "it": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Titre principal de la diapositive."
              },
              "subtitle": {
                "type": "string",
                "description": "Ligne secondaire sous le titre."
              },
              "description": {
                "type": "string",
                "description": "Paragraphe descriptif plus long pour la diapositive."
              },
              "btn1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
              }
            }
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Titre principal de la diapositive."
              },
              "subtitle": {
                "type": "string",
                "description": "Ligne secondaire sous le titre."
              },
              "description": {
                "type": "string",
                "description": "Paragraphe descriptif plus long pour la diapositive."
              },
              "btn1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
              }
            }
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Titre principal de la diapositive."
              },
              "subtitle": {
                "type": "string",
                "description": "Ligne secondaire sous le titre."
              },
              "description": {
                "type": "string",
                "description": "Paragraphe descriptif plus long pour la diapositive."
              },
              "btn1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
              }
            }
          },
          "de": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Titre principal de la diapositive."
              },
              "subtitle": {
                "type": "string",
                "description": "Ligne secondaire sous le titre."
              },
              "description": {
                "type": "string",
                "description": "Paragraphe descriptif plus long pour la diapositive."
              },
              "btn1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
              }
            }
          },
          "es": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Titre principal de la diapositive."
              },
              "subtitle": {
                "type": "string",
                "description": "Ligne secondaire sous le titre."
              },
              "description": {
                "type": "string",
                "description": "Paragraphe descriptif plus long pour la diapositive."
              },
              "btn1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
              }
            }
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Titre principal de la diapositive."
              },
              "subtitle": {
                "type": "string",
                "description": "Ligne secondaire sous le titre."
              },
              "description": {
                "type": "string",
                "description": "Paragraphe descriptif plus long pour la diapositive."
              },
              "btn1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
              }
            }
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
              },
              "title": {
                "type": "string",
                "description": "Titre principal de la diapositive."
              },
              "subtitle": {
                "type": "string",
                "description": "Ligne secondaire sous le titre."
              },
              "description": {
                "type": "string",
                "description": "Paragraphe descriptif plus long pour la diapositive."
              },
              "btn1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
              },
              "btn2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
              }
            }
          }
        },
        "description": "Diapositive de la bannière principale : image d’arrière-plan + titres + jusqu’à deux boutons d’appel à l’action. Les textes traduisibles suivent la convention de surcharge i18n.",
        "required": [
          "image"
        ]
      },
      "SiteSection": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "enum": [
              "EVENTS_PREVIEW",
              "CAISSES_PREVIEW",
              "HORAIRES_PREVIEW",
              "ARTICLES_PREVIEW",
              "GALLERY_PREVIEW",
              "BANNERS",
              "DONATION_STRIP",
              "CONTACT_BLOCK",
              "NEWSLETTER",
              "MAIN_CONTENT",
              "CUSTOM_CONTENT",
              "SHABBAT_TIMES",
              "ZMANIM"
            ],
            "description": "Type de section. *_PREVIEW = aperçu d’événements/cagnottes/horaires/articles/galerie ; BANNERS = bande de bannières promotionnelles ; DONATION_STRIP/NEWSLETTER/CONTACT_BLOCK = blocs prédéfinis ; MAIN_CONTENT = page d’accueil avec éditeur enrichi ; CUSTOM_CONTENT = bloc libre IA/éditeur ; SHABBAT_TIMES = horaires du prochain Shabbat (allumage des bougies, havdala, paracha) calculés automatiquement selon la position de l’organisation, avec un `style` (BANNER|CARD|TILES) et un CTA facultatif (ctaLabel + ctaUrl) ; ZMANIM = horaires halakhiques du jour (zmanim : alot hashahar, netz, sof zman shma, hatsot, plag, shkia, tset…) calculés automatiquement selon la position de l’organisation, avec `limit` facultatif."
          },
          "label": {
            "type": "string",
            "description": "Libellé de section destiné à l’admin (affichage uniquement)."
          },
          "hidden": {
            "type": "boolean",
            "description": "Masquer la section sans la supprimer."
          },
          "editable": {
            "type": "boolean",
            "description": "Indicateur réservé à l’interface admin (les sections intégrées ne peuvent pas être supprimées). Transmis tel quel ; généralement laissé à la valeur renvoyée par GET."
          },
          "props": {
            "type": "object",
            "properties": {
              "eyebrow": {
                "type": "string",
                "description": "Petit texte introductif/surtitre au-dessus du titre."
              },
              "title": {
                "type": "string",
                "description": "Titre de la section."
              },
              "subtitle": {
                "type": "string",
                "description": "Sous-titre de la section."
              },
              "description": {
                "type": "string",
                "description": "Paragraphe descriptif de la section."
              },
              "ctaLabel": {
                "type": "string",
                "description": "Libellé du bouton d’appel à l’action."
              },
              "ctaUrl": {
                "type": "string",
                "description": "Cible de l’appel à l’action (chemin interne ou URL complète)."
              },
              "limit": {
                "type": "number",
                "description": "Nombre maximal d’éléments à afficher en aperçu (sections PREVIEW)."
              },
              "style": {
                "type": "string",
                "enum": [
                  "BANNER",
                  "CARD",
                  "TILES"
                ],
                "description": "Pour SHABBAT_TIMES : mise en page visuelle — \"BANNER\" (bandeau pleine largeur, par défaut), \"CARD\" (carte centrée), \"TILES\" (en-tête de paracha + deux grandes vignettes horaires)."
              },
              "contentType": {
                "type": "string",
                "enum": [
                  "EDITOR",
                  "AI"
                ],
                "description": "Pour CUSTOM_CONTENT : \"AI\" affiche un bloc de contenu IA (définir aiContentBlockId), \"EDITOR\" affiche la page de l’éditeur enrichi (définir editorPageId)."
              },
              "aiContentBlockId": {
                "type": "string",
                "description": "Pour une section CUSTOM_CONTENT avec contentType=\"AI\" : identifiant du bloc de contenu IA à afficher. Écrivez le HTML du bloc via PUT /content-blocks/{id}/content (upsert), puis référencez ici son identifiant."
              },
              "editorPageId": {
                "type": "string",
                "description": "Pour une section CUSTOM_CONTENT avec contentType=\"EDITOR\" : identifiant de la page de l’éditeur enrichi dont le contenu est affiché dans la page."
              },
              "source": {
                "type": "string",
                "description": "Clé interne de source de données pour les sections intégrées (par ex. \"banners.items\" pour une section BANNERS intégrée). Généralement conservée telle que renvoyée par GET."
              }
            },
            "description": "Personnalisation de la section. Les clés pertinentes dépendent de son `type` (par ex. les types PREVIEW lisent eyebrow/title/subtitle/limit ; DONATION_STRIP/NEWSLETTER lisent eyebrow/title/description/ctaLabel/ctaUrl ; CUSTOM_CONTENT lit contentType + aiContentBlockId)."
          }
        },
        "description": "Section de la page d’accueil ou du pied de page : un `type`, des indicateurs d’affichage et un objet `props` dont les clés pertinentes dépendent du type.",
        "required": [
          "type"
        ]
      },
      "SiteMenu": {
        "type": "object",
        "properties": {
          "button_1_label": {
            "type": "string",
            "description": "Libellé du premier bouton d’en-tête (par ex. \"Don\")."
          },
          "button_1_url": {
            "type": "string",
            "description": "Cible du premier bouton : chemin interne (\"/don\") ou URL complète."
          },
          "button_1_icon": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
              },
              "source": {
                "type": "string",
                "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
              }
            },
            "description": "Icône du premier bouton."
          },
          "button_2_label": {
            "type": "string",
            "description": "Libellé du deuxième bouton d’en-tête (vide = pas de deuxième bouton)."
          },
          "button_2_url": {
            "type": "string",
            "description": "Cible du deuxième bouton."
          },
          "button_2_icon": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
              },
              "source": {
                "type": "string",
                "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
              }
            },
            "description": "Icône du deuxième bouton."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’en-tête (par ex. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’en-tête (vide = pas de deuxième bouton)."
              }
            }
          },
          "en": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’en-tête (par ex. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’en-tête (vide = pas de deuxième bouton)."
              }
            }
          },
          "he": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’en-tête (par ex. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’en-tête (vide = pas de deuxième bouton)."
              }
            }
          },
          "it": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’en-tête (par ex. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’en-tête (vide = pas de deuxième bouton)."
              }
            }
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’en-tête (par ex. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’en-tête (vide = pas de deuxième bouton)."
              }
            }
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’en-tête (par ex. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’en-tête (vide = pas de deuxième bouton)."
              }
            }
          },
          "de": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’en-tête (par ex. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’en-tête (vide = pas de deuxième bouton)."
              }
            }
          },
          "es": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’en-tête (par ex. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’en-tête (vide = pas de deuxième bouton)."
              }
            }
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’en-tête (par ex. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’en-tête (vide = pas de deuxième bouton)."
              }
            }
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "button_1_label": {
                "type": "string",
                "description": "Libellé du premier bouton d’en-tête (par ex. \"Don\")."
              },
              "button_2_label": {
                "type": "string",
                "description": "Libellé du deuxième bouton d’en-tête (vide = pas de deuxième bouton)."
              }
            }
          }
        },
        "description": "Les deux boutons d’appel à l’action affichés dans l’en-tête du site web (PAS l’arborescence de navigation — elle relève de la ressource Menu). Le bouton 2 est facultatif (laisser son libellé vide pour le masquer)."
      },
      "SiteAppearance": {
        "type": "object",
        "properties": {
          "theme": {
            "type": "string",
            "enum": [
              "DEFAULT",
              "2026"
            ],
            "description": "Thème actif du site web classique. \"DEFAULT\" = thème Ummah classique ; \"2026\" = thème moderne (utilise `tokens` et prend en charge la bannière principale, les sections, les bannières et les boutons d’en-tête)."
          },
          "tokens": {
            "type": "object",
            "properties": {
              "primary": {
                "type": "string",
                "description": "Couleur principale de marque (hexadécimale), par ex. \"#1B2A4E\"."
              },
              "secondary": {
                "type": "string",
                "description": "Couleur secondaire/d’accent (hexadécimale)."
              },
              "bg": {
                "type": "string",
                "description": "Couleur d’arrière-plan de page (hexadécimale)."
              },
              "surface": {
                "type": "string",
                "description": "Couleur d’arrière-plan des cartes/surfaces (hexadécimale)."
              },
              "ink": {
                "type": "string",
                "description": "Couleur du texte principal (hexadécimale)."
              },
              "fontDisplay": {
                "type": "string",
                "description": "Pile de polices des titres, par ex. \"Fraunces, ui-serif, Georgia, serif\"."
              },
              "fontBody": {
                "type": "string",
                "description": "Pile de polices du corps de texte, par ex. \"Inter, system-ui, sans-serif\"."
              }
            },
            "description": "Tokens de design du thème 2026, injectés comme variables CSS sur le site public. Les couleurs sont des chaînes hexadécimales ; les polices sont des piles CSS font-family (Google Fonts autorisées). Omettez un token pour conserver sa valeur par défaut."
          }
        },
        "description": "Apparence générale du site classique : thème actif et tokens de couleur/police du thème 2026. Envoyez `theme` et/ou `tokens` — chaque champ fourni remplace la valeur cible (theme → org.web.theme, tokens → org.web.theme2026.tokens)."
      },
      "SiteDonationPage": {
        "type": "object",
        "properties": {
          "youtube": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant de vidéo YouTube (pas l’URL complète). Une chaîne vide ou null supprime la vidéo."
          },
          "backgroundImage": {
            "type": "string",
            "description": "Image d’arrière-plan de page. Une chaîne vide ou null la supprime. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
            "nullable": true
          },
          "content": {
            "type": "string",
            "nullable": true,
            "description": "Contenu enrichi de la page en HTML (valeur de l’éditeur enrichi admin). Une chaîne vide ou null l’efface."
          },
          "carousel": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
            },
            "description": "Noms de fichiers d’images ou URL d’images HTTP(S) (réhébergées), dans l’ordre. Remplace tout le carrousel ; [] le vide."
          },
          "presetButtons": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "montant": {
                  "type": "number",
                  "minimum": 1,
                  "description": "Montant suggéré en unités majeures de la devise, minimum 1 (pas en centimes)."
                },
                "text": {
                  "type": "string",
                  "description": "Libellé de bouton personnalisé facultatif ; vide = montant et devise formatés."
                }
              },
              "required": [
                "montant"
              ],
              "additionalProperties": false
            },
            "description": "Montants de don suggérés, dans l’ordre. Remplace toute la liste ; [] rétablit les montants par défaut du thème. Chaque montant est en unités MAJEURES de la devise (50 = 50 unités monétaires), minimum 1. Un texte vide affiche le montant et la devise formatés. Chaque langue peut fournir sa propre liste complète, comme dans l’éditeur admin."
          },
          "mainCaisse": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant d’une cagnotte appartenant à cette organisation, utilisée par la page de don principale. Son contenu/média/montants prédéfinis remplacent les valeurs de cette page. Une chaîne vide ou null rétablit les dons généraux. Gérez la cagnotte elle-même via /cagnottes."
          },
          "redirect": {
            "type": "string",
            "nullable": true,
            "description": "Redirection pour la seule route principale /don (pas pour les pages individuelles de cagnotte) : chemin local commençant par / ou URL HTTP(S) absolue. Une chaîne vide ou null désactive la redirection."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "Identifiant de vidéo YouTube (pas l’URL complète). Une chaîne vide ou null supprime la vidéo."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Image d’arrière-plan de page. Une chaîne vide ou null la supprime. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Contenu enrichi de la page en HTML (valeur de l’éditeur enrichi admin). Une chaîne vide ou null l’efface."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
                },
                "description": "Noms de fichiers d’images ou URL d’images HTTP(S) (réhébergées), dans l’ordre. Remplace tout le carrousel ; [] le vide."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Montant suggéré en unités majeures de la devise, minimum 1 (pas en centimes)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Libellé de bouton personnalisé facultatif ; vide = montant et devise formatés."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Montants de don suggérés, dans l’ordre. Remplace toute la liste ; [] rétablit les montants par défaut du thème. Chaque montant est en unités MAJEURES de la devise (50 = 50 unités monétaires), minimum 1. Un texte vide affiche le montant et la devise formatés. Chaque langue peut fournir sa propre liste complète, comme dans l’éditeur admin."
              }
            },
            "additionalProperties": false
          },
          "en": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "Identifiant de vidéo YouTube (pas l’URL complète). Une chaîne vide ou null supprime la vidéo."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Image d’arrière-plan de page. Une chaîne vide ou null la supprime. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Contenu enrichi de la page en HTML (valeur de l’éditeur enrichi admin). Une chaîne vide ou null l’efface."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
                },
                "description": "Noms de fichiers d’images ou URL d’images HTTP(S) (réhébergées), dans l’ordre. Remplace tout le carrousel ; [] le vide."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Montant suggéré en unités majeures de la devise, minimum 1 (pas en centimes)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Libellé de bouton personnalisé facultatif ; vide = montant et devise formatés."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Montants de don suggérés, dans l’ordre. Remplace toute la liste ; [] rétablit les montants par défaut du thème. Chaque montant est en unités MAJEURES de la devise (50 = 50 unités monétaires), minimum 1. Un texte vide affiche le montant et la devise formatés. Chaque langue peut fournir sa propre liste complète, comme dans l’éditeur admin."
              }
            },
            "additionalProperties": false
          },
          "he": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "Identifiant de vidéo YouTube (pas l’URL complète). Une chaîne vide ou null supprime la vidéo."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Image d’arrière-plan de page. Une chaîne vide ou null la supprime. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Contenu enrichi de la page en HTML (valeur de l’éditeur enrichi admin). Une chaîne vide ou null l’efface."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
                },
                "description": "Noms de fichiers d’images ou URL d’images HTTP(S) (réhébergées), dans l’ordre. Remplace tout le carrousel ; [] le vide."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Montant suggéré en unités majeures de la devise, minimum 1 (pas en centimes)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Libellé de bouton personnalisé facultatif ; vide = montant et devise formatés."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Montants de don suggérés, dans l’ordre. Remplace toute la liste ; [] rétablit les montants par défaut du thème. Chaque montant est en unités MAJEURES de la devise (50 = 50 unités monétaires), minimum 1. Un texte vide affiche le montant et la devise formatés. Chaque langue peut fournir sa propre liste complète, comme dans l’éditeur admin."
              }
            },
            "additionalProperties": false
          },
          "it": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "Identifiant de vidéo YouTube (pas l’URL complète). Une chaîne vide ou null supprime la vidéo."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Image d’arrière-plan de page. Une chaîne vide ou null la supprime. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Contenu enrichi de la page en HTML (valeur de l’éditeur enrichi admin). Une chaîne vide ou null l’efface."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
                },
                "description": "Noms de fichiers d’images ou URL d’images HTTP(S) (réhébergées), dans l’ordre. Remplace tout le carrousel ; [] le vide."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Montant suggéré en unités majeures de la devise, minimum 1 (pas en centimes)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Libellé de bouton personnalisé facultatif ; vide = montant et devise formatés."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Montants de don suggérés, dans l’ordre. Remplace toute la liste ; [] rétablit les montants par défaut du thème. Chaque montant est en unités MAJEURES de la devise (50 = 50 unités monétaires), minimum 1. Un texte vide affiche le montant et la devise formatés. Chaque langue peut fournir sa propre liste complète, comme dans l’éditeur admin."
              }
            },
            "additionalProperties": false
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "Identifiant de vidéo YouTube (pas l’URL complète). Une chaîne vide ou null supprime la vidéo."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Image d’arrière-plan de page. Une chaîne vide ou null la supprime. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Contenu enrichi de la page en HTML (valeur de l’éditeur enrichi admin). Une chaîne vide ou null l’efface."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
                },
                "description": "Noms de fichiers d’images ou URL d’images HTTP(S) (réhébergées), dans l’ordre. Remplace tout le carrousel ; [] le vide."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Montant suggéré en unités majeures de la devise, minimum 1 (pas en centimes)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Libellé de bouton personnalisé facultatif ; vide = montant et devise formatés."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Montants de don suggérés, dans l’ordre. Remplace toute la liste ; [] rétablit les montants par défaut du thème. Chaque montant est en unités MAJEURES de la devise (50 = 50 unités monétaires), minimum 1. Un texte vide affiche le montant et la devise formatés. Chaque langue peut fournir sa propre liste complète, comme dans l’éditeur admin."
              }
            },
            "additionalProperties": false
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "Identifiant de vidéo YouTube (pas l’URL complète). Une chaîne vide ou null supprime la vidéo."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Image d’arrière-plan de page. Une chaîne vide ou null la supprime. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Contenu enrichi de la page en HTML (valeur de l’éditeur enrichi admin). Une chaîne vide ou null l’efface."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
                },
                "description": "Noms de fichiers d’images ou URL d’images HTTP(S) (réhébergées), dans l’ordre. Remplace tout le carrousel ; [] le vide."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Montant suggéré en unités majeures de la devise, minimum 1 (pas en centimes)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Libellé de bouton personnalisé facultatif ; vide = montant et devise formatés."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Montants de don suggérés, dans l’ordre. Remplace toute la liste ; [] rétablit les montants par défaut du thème. Chaque montant est en unités MAJEURES de la devise (50 = 50 unités monétaires), minimum 1. Un texte vide affiche le montant et la devise formatés. Chaque langue peut fournir sa propre liste complète, comme dans l’éditeur admin."
              }
            },
            "additionalProperties": false
          },
          "de": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "Identifiant de vidéo YouTube (pas l’URL complète). Une chaîne vide ou null supprime la vidéo."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Image d’arrière-plan de page. Une chaîne vide ou null la supprime. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Contenu enrichi de la page en HTML (valeur de l’éditeur enrichi admin). Une chaîne vide ou null l’efface."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
                },
                "description": "Noms de fichiers d’images ou URL d’images HTTP(S) (réhébergées), dans l’ordre. Remplace tout le carrousel ; [] le vide."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Montant suggéré en unités majeures de la devise, minimum 1 (pas en centimes)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Libellé de bouton personnalisé facultatif ; vide = montant et devise formatés."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Montants de don suggérés, dans l’ordre. Remplace toute la liste ; [] rétablit les montants par défaut du thème. Chaque montant est en unités MAJEURES de la devise (50 = 50 unités monétaires), minimum 1. Un texte vide affiche le montant et la devise formatés. Chaque langue peut fournir sa propre liste complète, comme dans l’éditeur admin."
              }
            },
            "additionalProperties": false
          },
          "es": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "Identifiant de vidéo YouTube (pas l’URL complète). Une chaîne vide ou null supprime la vidéo."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Image d’arrière-plan de page. Une chaîne vide ou null la supprime. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Contenu enrichi de la page en HTML (valeur de l’éditeur enrichi admin). Une chaîne vide ou null l’efface."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
                },
                "description": "Noms de fichiers d’images ou URL d’images HTTP(S) (réhébergées), dans l’ordre. Remplace tout le carrousel ; [] le vide."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Montant suggéré en unités majeures de la devise, minimum 1 (pas en centimes)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Libellé de bouton personnalisé facultatif ; vide = montant et devise formatés."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Montants de don suggérés, dans l’ordre. Remplace toute la liste ; [] rétablit les montants par défaut du thème. Chaque montant est en unités MAJEURES de la devise (50 = 50 unités monétaires), minimum 1. Un texte vide affiche le montant et la devise formatés. Chaque langue peut fournir sa propre liste complète, comme dans l’éditeur admin."
              }
            },
            "additionalProperties": false
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "Identifiant de vidéo YouTube (pas l’URL complète). Une chaîne vide ou null supprime la vidéo."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Image d’arrière-plan de page. Une chaîne vide ou null la supprime. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Contenu enrichi de la page en HTML (valeur de l’éditeur enrichi admin). Une chaîne vide ou null l’efface."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
                },
                "description": "Noms de fichiers d’images ou URL d’images HTTP(S) (réhébergées), dans l’ordre. Remplace tout le carrousel ; [] le vide."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Montant suggéré en unités majeures de la devise, minimum 1 (pas en centimes)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Libellé de bouton personnalisé facultatif ; vide = montant et devise formatés."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Montants de don suggérés, dans l’ordre. Remplace toute la liste ; [] rétablit les montants par défaut du thème. Chaque montant est en unités MAJEURES de la devise (50 = 50 unités monétaires), minimum 1. Un texte vide affiche le montant et la devise formatés. Chaque langue peut fournir sa propre liste complète, comme dans l’éditeur admin."
              }
            },
            "additionalProperties": false
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "youtube": {
                "type": "string",
                "nullable": true,
                "description": "Identifiant de vidéo YouTube (pas l’URL complète). Une chaîne vide ou null supprime la vidéo."
              },
              "backgroundImage": {
                "type": "string",
                "description": "Image d’arrière-plan de page. Une chaîne vide ou null la supprime. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              },
              "content": {
                "type": "string",
                "nullable": true,
                "description": "Contenu enrichi de la page en HTML (valeur de l’éditeur enrichi admin). Une chaîne vide ou null l’efface."
              },
              "carousel": {
                "type": "array",
                "items": {
                  "type": "string",
                  "description": "Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
                },
                "description": "Noms de fichiers d’images ou URL d’images HTTP(S) (réhébergées), dans l’ordre. Remplace tout le carrousel ; [] le vide."
              },
              "presetButtons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "montant": {
                      "type": "number",
                      "minimum": 1,
                      "description": "Montant suggéré en unités majeures de la devise, minimum 1 (pas en centimes)."
                    },
                    "text": {
                      "type": "string",
                      "description": "Libellé de bouton personnalisé facultatif ; vide = montant et devise formatés."
                    }
                  },
                  "required": [
                    "montant"
                  ],
                  "additionalProperties": false
                },
                "description": "Montants de don suggérés, dans l’ordre. Remplace toute la liste ; [] rétablit les montants par défaut du thème. Chaque montant est en unités MAJEURES de la devise (50 = 50 unités monétaires), minimum 1. Un texte vide affiche le montant et la devise formatés. Chaque langue peut fournir sa propre liste complète, comme dans l’éditeur admin."
              }
            },
            "additionalProperties": false
          }
        },
        "description": "Paramètres de la page de don principale (admin « Ma page de don »), partagés par les thèmes classique, Travel et mobile. Mise à jour partielle : champs et traductions omis conservés. Les tableaux de médias/montants prédéfinis remplacent le tableau fourni. Les valeurs de la langue par défaut sont à la racine ; les autres langues peuvent remplacer les cinq champs de présentation, y compris les tableaux entiers. Une cagnotte `mainCaisse` associée fournit son propre contenu/média/montants prédéfinis ; la redirection prévaut sur la page /don principale. Ne modifie ni les paramètres généraux des fournisseurs de paiement de l’organisation ni la configuration de campagne.",
        "additionalProperties": false
      },
      "SiteSeo": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "nullable": true,
            "description": "Titre de page par défaut, également utilisé pour Open Graph et Twitter. Les suffixes de site propres au thème sont conservés."
          },
          "description": {
            "type": "string",
            "nullable": true,
            "description": "Description meta et description de partage social par défaut."
          },
          "image": {
            "type": "string",
            "description": "Image de partage social par défaut. Les URL HTTP(S) sont réhébergées, y compris les images des autres langues. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
            "nullable": true
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Titre de page par défaut, également utilisé pour Open Graph et Twitter. Les suffixes de site propres au thème sont conservés."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et description de partage social par défaut."
              },
              "image": {
                "type": "string",
                "description": "Image de partage social par défaut. Les URL HTTP(S) sont réhébergées, y compris les images des autres langues. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              }
            },
            "additionalProperties": false
          },
          "en": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Titre de page par défaut, également utilisé pour Open Graph et Twitter. Les suffixes de site propres au thème sont conservés."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et description de partage social par défaut."
              },
              "image": {
                "type": "string",
                "description": "Image de partage social par défaut. Les URL HTTP(S) sont réhébergées, y compris les images des autres langues. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              }
            },
            "additionalProperties": false
          },
          "he": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Titre de page par défaut, également utilisé pour Open Graph et Twitter. Les suffixes de site propres au thème sont conservés."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et description de partage social par défaut."
              },
              "image": {
                "type": "string",
                "description": "Image de partage social par défaut. Les URL HTTP(S) sont réhébergées, y compris les images des autres langues. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              }
            },
            "additionalProperties": false
          },
          "it": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Titre de page par défaut, également utilisé pour Open Graph et Twitter. Les suffixes de site propres au thème sont conservés."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et description de partage social par défaut."
              },
              "image": {
                "type": "string",
                "description": "Image de partage social par défaut. Les URL HTTP(S) sont réhébergées, y compris les images des autres langues. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              }
            },
            "additionalProperties": false
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Titre de page par défaut, également utilisé pour Open Graph et Twitter. Les suffixes de site propres au thème sont conservés."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et description de partage social par défaut."
              },
              "image": {
                "type": "string",
                "description": "Image de partage social par défaut. Les URL HTTP(S) sont réhébergées, y compris les images des autres langues. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              }
            },
            "additionalProperties": false
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Titre de page par défaut, également utilisé pour Open Graph et Twitter. Les suffixes de site propres au thème sont conservés."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et description de partage social par défaut."
              },
              "image": {
                "type": "string",
                "description": "Image de partage social par défaut. Les URL HTTP(S) sont réhébergées, y compris les images des autres langues. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              }
            },
            "additionalProperties": false
          },
          "de": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Titre de page par défaut, également utilisé pour Open Graph et Twitter. Les suffixes de site propres au thème sont conservés."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et description de partage social par défaut."
              },
              "image": {
                "type": "string",
                "description": "Image de partage social par défaut. Les URL HTTP(S) sont réhébergées, y compris les images des autres langues. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              }
            },
            "additionalProperties": false
          },
          "es": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Titre de page par défaut, également utilisé pour Open Graph et Twitter. Les suffixes de site propres au thème sont conservés."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et description de partage social par défaut."
              },
              "image": {
                "type": "string",
                "description": "Image de partage social par défaut. Les URL HTTP(S) sont réhébergées, y compris les images des autres langues. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              }
            },
            "additionalProperties": false
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Titre de page par défaut, également utilisé pour Open Graph et Twitter. Les suffixes de site propres au thème sont conservés."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et description de partage social par défaut."
              },
              "image": {
                "type": "string",
                "description": "Image de partage social par défaut. Les URL HTTP(S) sont réhébergées, y compris les images des autres langues. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              }
            },
            "additionalProperties": false
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "title": {
                "type": "string",
                "nullable": true,
                "description": "Titre de page par défaut, également utilisé pour Open Graph et Twitter. Les suffixes de site propres au thème sont conservés."
              },
              "description": {
                "type": "string",
                "nullable": true,
                "description": "Description meta et description de partage social par défaut."
              },
              "image": {
                "type": "string",
                "description": "Image de partage social par défaut. Les URL HTTP(S) sont réhébergées, y compris les images des autres langues. Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé.",
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        },
        "description": "SEO par défaut pour la page d’accueil et toute page CMS publique sans SEO propre. Chaque champ est résolu indépendamment : SEO explicite de la page, puis valeur par défaut du site, puis valeur générée automatiquement existante. S’applique aux thèmes classique, Travel, mobile et campagne. Les valeurs de la langue par défaut sont à la racine ; les autres langues activées utilisent des surcharges partielles. Les champs/surcharges omis sont conservés ; null ou une chaîne vide efface une valeur individuelle (rétablit la valeur de repli). Un objet de langue null/vide supprime uniquement cette surcharge.",
        "additionalProperties": false
      },
      "SiteConfig": {
        "type": "object",
        "description": "Configuration normalisée du thème classique du site pour une façade (correspondance 1:1 avec les sections PATCH /site/*).",
        "properties": {
          "appearance": {
            "$ref": "#/components/schemas/SiteAppearance"
          },
          "menu": {
            "$ref": "#/components/schemas/SiteMenu"
          },
          "hero": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SiteSlide"
            }
          },
          "banners": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SiteSlide"
            }
          },
          "homeSections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SiteSection"
            }
          },
          "preFooterSections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SiteSection"
            }
          },
          "donationPage": {
            "$ref": "#/components/schemas/SiteDonationPage"
          },
          "seo": {
            "$ref": "#/components/schemas/SiteSeo"
          }
        }
      },
      "SiteFacade": {
        "type": "object",
        "description": "Une façade = un site public de l’organisation. Le site principal a virtualId=null ; chaque site virtuel possède son propre identifiant.",
        "properties": {
          "virtualId": {
            "type": "string",
            "nullable": true,
            "description": "Transmettez cette valeur via `?virtualId=` pour cibler la façade. null = site principal."
          },
          "label": {
            "type": "string"
          }
        }
      },
      "MobileTab": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifiant généré par le serveur (uuid). Omettre lors de la création d’un onglet ; conserver lors de la modification d’un onglet existant."
          },
          "url": {
            "type": "string",
            "description": "Destination de l’onglet : chemin interne (\"/don\" ou \"\" = accueil) OU URL externe complète (\"https://…\"). Texte libre.",
            "example": "/don"
          },
          "label": {
            "type": "string",
            "description": "Libellé d’onglet affiché sous l’icône (traduisible).",
            "example": "Accueil"
          },
          "icon": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
              },
              "source": {
                "type": "string",
                "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
              }
            },
            "description": "Icône de l’onglet."
          },
          "order": {
            "type": "number",
            "description": "Ordre d’affichage (la valeur la plus basse s’affiche en premier). Généralement géré par l’ordre du tableau.",
            "example": 0
          },
          "active": {
            "type": "boolean",
            "description": "Indique si l’onglet est affiché. true par défaut."
          },
          "fr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Libellé d’onglet affiché sous l’icône (traduisible).",
                "example": "Accueil"
              }
            }
          },
          "en": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Libellé d’onglet affiché sous l’icône (traduisible).",
                "example": "Accueil"
              }
            }
          },
          "he": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Libellé d’onglet affiché sous l’icône (traduisible).",
                "example": "Accueil"
              }
            }
          },
          "it": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Libellé d’onglet affiché sous l’icône (traduisible).",
                "example": "Accueil"
              }
            }
          },
          "ru": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Libellé d’onglet affiché sous l’icône (traduisible).",
                "example": "Accueil"
              }
            }
          },
          "pt": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Libellé d’onglet affiché sous l’icône (traduisible).",
                "example": "Accueil"
              }
            }
          },
          "de": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Libellé d’onglet affiché sous l’icône (traduisible).",
                "example": "Accueil"
              }
            }
          },
          "es": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Libellé d’onglet affiché sous l’icône (traduisible).",
                "example": "Accueil"
              }
            }
          },
          "gr": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Libellé d’onglet affiché sous l’icône (traduisible).",
                "example": "Accueil"
              }
            }
          },
          "ro": {
            "type": "object",
            "nullable": true,
            "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
            "properties": {
              "label": {
                "type": "string",
                "description": "Libellé d’onglet affiché sous l’icône (traduisible).",
                "example": "Accueil"
              }
            }
          }
        },
        "description": "Onglet de la barre inférieure : URL de destination + libellé i18n + icône."
      },
      "MobileSection": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifiant généré par le serveur (uuid). Omettre à la création ; conserver lors d’une modification (appeler d’abord GET /mobile-config pour préserver les identifiants existants)."
          },
          "type": {
            "type": "string",
            "enum": [
              "HERO",
              "HERO_STORIES",
              "BANNERS",
              "ACTIONS_GRID",
              "H_CAROUSEL",
              "ANNOUNCEMENT",
              "EVENTS_PREVIEW",
              "CAISSES_PREVIEW",
              "HORAIRES_PREVIEW",
              "ARTICLES_PREVIEW",
              "GALLERY_PREVIEW",
              "CONTACT_BLOCK",
              "DONATION_STRIP",
              "NEWSLETTER",
              "SHABBAT_TIMES",
              "DAILY_OFFICES",
              "ZMANIM",
              "CUSTOM_CONTENT",
              "MAIN_CONTENT"
            ],
            "description": "Type de section. HERO / HERO_STORIES = carrousel de diapositives avec son propre contenu ; ACTIONS_GRID = raccourcis tactiles ; H_CAROUSEL = carrousel horizontal d’événements/cagnottes ; ANNOUNCEMENT = bannière d’information/avertissement/urgence masquable ; *_PREVIEW = aperçu d’événements/cagnottes/horaires/articles/galerie ; CONTACT_BLOCK/DONATION_STRIP/NEWSLETTER = blocs prédéfinis ; SHABBAT_TIMES = horaires du prochain Shabbat ; DAILY_OFFICES = horaires de prière du jour ; ZMANIM = horaires halakhiques du jour calculés automatiquement selon la position de l’organisation, avec `limit` facultatif ; CUSTOM_CONTENT = bloc libre IA/éditeur ; MAIN_CONTENT = page d’accueil avec éditeur enrichi.",
            "example": "ACTIONS_GRID"
          },
          "label": {
            "type": "string",
            "description": "Libellé de section destiné à l’admin (affichage uniquement)."
          },
          "hidden": {
            "type": "boolean",
            "description": "Masquer la section sans la supprimer."
          },
          "order": {
            "type": "number",
            "description": "Ordre d’affichage (la valeur la plus basse s’affiche en premier). Généralement l’ordre du tableau."
          },
          "props": {
            "type": "object",
            "properties": {
              "slides": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "image": {
                      "type": "string",
                      "description": "Image d’arrière-plan de la diapositive (obligatoire). Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
                    },
                    "eyebrow_icon": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
                        },
                        "source": {
                          "type": "string",
                          "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
                        }
                      },
                      "description": "Petite icône affichée à côté du texte introductif."
                    },
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre principal de la diapositive."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Ligne secondaire sous le titre."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long pour la diapositive."
                    },
                    "btn1_label": {
                      "type": "string",
                      "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn1_url": {
                      "type": "string",
                      "description": "URL cible du premier bouton."
                    },
                    "btn1_icon": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
                        },
                        "source": {
                          "type": "string",
                          "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
                        }
                      },
                      "description": "Icône du premier bouton."
                    },
                    "btn2_label": {
                      "type": "string",
                      "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                    },
                    "btn2_url": {
                      "type": "string",
                      "description": "URL cible du deuxième bouton."
                    },
                    "btn2_icon": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
                        },
                        "source": {
                          "type": "string",
                          "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
                        }
                      },
                      "description": "Icône du deuxième bouton."
                    },
                    "fr": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "eyebrow": {
                          "type": "string",
                          "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                        },
                        "title": {
                          "type": "string",
                          "description": "Titre principal de la diapositive."
                        },
                        "subtitle": {
                          "type": "string",
                          "description": "Ligne secondaire sous le titre."
                        },
                        "description": {
                          "type": "string",
                          "description": "Paragraphe descriptif plus long pour la diapositive."
                        },
                        "btn1_label": {
                          "type": "string",
                          "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                        },
                        "btn2_label": {
                          "type": "string",
                          "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                        }
                      }
                    },
                    "en": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "eyebrow": {
                          "type": "string",
                          "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                        },
                        "title": {
                          "type": "string",
                          "description": "Titre principal de la diapositive."
                        },
                        "subtitle": {
                          "type": "string",
                          "description": "Ligne secondaire sous le titre."
                        },
                        "description": {
                          "type": "string",
                          "description": "Paragraphe descriptif plus long pour la diapositive."
                        },
                        "btn1_label": {
                          "type": "string",
                          "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                        },
                        "btn2_label": {
                          "type": "string",
                          "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                        }
                      }
                    },
                    "he": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "eyebrow": {
                          "type": "string",
                          "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                        },
                        "title": {
                          "type": "string",
                          "description": "Titre principal de la diapositive."
                        },
                        "subtitle": {
                          "type": "string",
                          "description": "Ligne secondaire sous le titre."
                        },
                        "description": {
                          "type": "string",
                          "description": "Paragraphe descriptif plus long pour la diapositive."
                        },
                        "btn1_label": {
                          "type": "string",
                          "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                        },
                        "btn2_label": {
                          "type": "string",
                          "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                        }
                      }
                    },
                    "it": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "eyebrow": {
                          "type": "string",
                          "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                        },
                        "title": {
                          "type": "string",
                          "description": "Titre principal de la diapositive."
                        },
                        "subtitle": {
                          "type": "string",
                          "description": "Ligne secondaire sous le titre."
                        },
                        "description": {
                          "type": "string",
                          "description": "Paragraphe descriptif plus long pour la diapositive."
                        },
                        "btn1_label": {
                          "type": "string",
                          "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                        },
                        "btn2_label": {
                          "type": "string",
                          "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                        }
                      }
                    },
                    "ru": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "eyebrow": {
                          "type": "string",
                          "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                        },
                        "title": {
                          "type": "string",
                          "description": "Titre principal de la diapositive."
                        },
                        "subtitle": {
                          "type": "string",
                          "description": "Ligne secondaire sous le titre."
                        },
                        "description": {
                          "type": "string",
                          "description": "Paragraphe descriptif plus long pour la diapositive."
                        },
                        "btn1_label": {
                          "type": "string",
                          "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                        },
                        "btn2_label": {
                          "type": "string",
                          "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                        }
                      }
                    },
                    "pt": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "eyebrow": {
                          "type": "string",
                          "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                        },
                        "title": {
                          "type": "string",
                          "description": "Titre principal de la diapositive."
                        },
                        "subtitle": {
                          "type": "string",
                          "description": "Ligne secondaire sous le titre."
                        },
                        "description": {
                          "type": "string",
                          "description": "Paragraphe descriptif plus long pour la diapositive."
                        },
                        "btn1_label": {
                          "type": "string",
                          "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                        },
                        "btn2_label": {
                          "type": "string",
                          "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                        }
                      }
                    },
                    "de": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "eyebrow": {
                          "type": "string",
                          "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                        },
                        "title": {
                          "type": "string",
                          "description": "Titre principal de la diapositive."
                        },
                        "subtitle": {
                          "type": "string",
                          "description": "Ligne secondaire sous le titre."
                        },
                        "description": {
                          "type": "string",
                          "description": "Paragraphe descriptif plus long pour la diapositive."
                        },
                        "btn1_label": {
                          "type": "string",
                          "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                        },
                        "btn2_label": {
                          "type": "string",
                          "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                        }
                      }
                    },
                    "es": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "eyebrow": {
                          "type": "string",
                          "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                        },
                        "title": {
                          "type": "string",
                          "description": "Titre principal de la diapositive."
                        },
                        "subtitle": {
                          "type": "string",
                          "description": "Ligne secondaire sous le titre."
                        },
                        "description": {
                          "type": "string",
                          "description": "Paragraphe descriptif plus long pour la diapositive."
                        },
                        "btn1_label": {
                          "type": "string",
                          "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                        },
                        "btn2_label": {
                          "type": "string",
                          "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                        }
                      }
                    },
                    "gr": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "eyebrow": {
                          "type": "string",
                          "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                        },
                        "title": {
                          "type": "string",
                          "description": "Titre principal de la diapositive."
                        },
                        "subtitle": {
                          "type": "string",
                          "description": "Ligne secondaire sous le titre."
                        },
                        "description": {
                          "type": "string",
                          "description": "Paragraphe descriptif plus long pour la diapositive."
                        },
                        "btn1_label": {
                          "type": "string",
                          "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                        },
                        "btn2_label": {
                          "type": "string",
                          "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                        }
                      }
                    },
                    "ro": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "eyebrow": {
                          "type": "string",
                          "description": "Petit texte introductif/surtitre au-dessus du titre (par ex. \"An Unforgettable Journey\")."
                        },
                        "title": {
                          "type": "string",
                          "description": "Titre principal de la diapositive."
                        },
                        "subtitle": {
                          "type": "string",
                          "description": "Ligne secondaire sous le titre."
                        },
                        "description": {
                          "type": "string",
                          "description": "Paragraphe descriptif plus long pour la diapositive."
                        },
                        "btn1_label": {
                          "type": "string",
                          "description": "Libellé du premier bouton d’appel à l’action (vide = aucun bouton)."
                        },
                        "btn2_label": {
                          "type": "string",
                          "description": "Libellé du deuxième bouton d’appel à l’action (vide = aucun bouton)."
                        }
                      }
                    }
                  },
                  "required": [
                    "image"
                  ]
                },
                "description": "Pour HERO / HERO_STORIES : diapositives de cette section (chacune possède son image, ses textes et ses boutons)."
              },
              "style": {
                "type": "string",
                "enum": [
                  "ROUND",
                  "GRID"
                ],
                "description": "Pour ACTIONS_GRID : mise en page des raccourcis — \"ROUND\" (boutons ronds défilants, par défaut) ou \"GRID\"."
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Identifiant généré par le serveur (uuid). Omettre à la création ; conserver lors de la modification."
                    },
                    "icon": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
                        },
                        "source": {
                          "type": "string",
                          "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
                        }
                      },
                      "description": "Icône du raccourci."
                    },
                    "label": {
                      "type": "string",
                      "description": "Libellé du raccourci (traduisible).",
                      "example": "Faire un don"
                    },
                    "url": {
                      "type": "string",
                      "description": "Destination du raccourci (chemin interne ou URL complète).",
                      "example": "/don"
                    },
                    "color": {
                      "type": "string",
                      "description": "Couleur d’accent facultative (hexadécimale). Vide → teinte principale de l’organisation.",
                      "example": "#1D4ED8"
                    },
                    "fr": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Libellé du raccourci (traduisible).",
                          "example": "Faire un don"
                        }
                      }
                    },
                    "en": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Libellé du raccourci (traduisible).",
                          "example": "Faire un don"
                        }
                      }
                    },
                    "he": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Libellé du raccourci (traduisible).",
                          "example": "Faire un don"
                        }
                      }
                    },
                    "it": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Libellé du raccourci (traduisible).",
                          "example": "Faire un don"
                        }
                      }
                    },
                    "ru": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Libellé du raccourci (traduisible).",
                          "example": "Faire un don"
                        }
                      }
                    },
                    "pt": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Libellé du raccourci (traduisible).",
                          "example": "Faire un don"
                        }
                      }
                    },
                    "de": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Libellé du raccourci (traduisible).",
                          "example": "Faire un don"
                        }
                      }
                    },
                    "es": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Libellé du raccourci (traduisible).",
                          "example": "Faire un don"
                        }
                      }
                    },
                    "gr": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Libellé du raccourci (traduisible).",
                          "example": "Faire un don"
                        }
                      }
                    },
                    "ro": {
                      "type": "object",
                      "nullable": true,
                      "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                      "properties": {
                        "label": {
                          "type": "string",
                          "description": "Libellé du raccourci (traduisible).",
                          "example": "Faire un don"
                        }
                      }
                    }
                  }
                },
                "description": "Pour ACTIONS_GRID : vignettes de raccourcis."
              },
              "source": {
                "type": "string",
                "enum": [
                  "EVENTS",
                  "CAISSES"
                ],
                "description": "Pour H_CAROUSEL : source de données du carrousel horizontal — événements ou cagnottes de collecte. (Également utilisée comme clé interne de source de données pour certaines sections intégrées.)"
              },
              "level": {
                "type": "string",
                "enum": [
                  "INFO",
                  "WARNING",
                  "URGENT"
                ],
                "description": "Pour ANNOUNCEMENT : gravité/couleur de la bannière."
              },
              "text": {
                "type": "string",
                "description": "Pour ANNOUNCEMENT : texte de la bannière (traduisible)."
              },
              "dismissible": {
                "type": "boolean",
                "description": "Pour ANNOUNCEMENT : autoriser l’utilisateur à masquer la bannière. true par défaut."
              },
              "url": {
                "type": "string",
                "description": "Pour ANNOUNCEMENT (et les blocs CTA) : lien cible (chemin interne ou URL complète)."
              },
              "eyebrow": {
                "type": "string",
                "description": "Petit texte introductif au-dessus du titre (traduisible)."
              },
              "title": {
                "type": "string",
                "description": "Titre de section (traduisible). Pour H_CAROUSEL, il s’agit du titre du carrousel."
              },
              "subtitle": {
                "type": "string",
                "description": "Sous-titre de section (traduisible)."
              },
              "description": {
                "type": "string",
                "description": "Paragraphe descriptif de la section (traduisible)."
              },
              "ctaLabel": {
                "type": "string",
                "description": "Libellé du bouton d’appel à l’action (traduisible)."
              },
              "ctaUrl": {
                "type": "string",
                "description": "Cible de l’appel à l’action (chemin interne ou URL complète)."
              },
              "limit": {
                "type": "number",
                "description": "Nombre maximal d’éléments à afficher en aperçu (sections PREVIEW / H_CAROUSEL)."
              },
              "contentType": {
                "type": "string",
                "enum": [
                  "EDITOR",
                  "AI"
                ],
                "description": "Pour CUSTOM_CONTENT : \"AI\" affiche un bloc de contenu IA (définir aiContentBlockId), \"EDITOR\" affiche la page de l’éditeur enrichi (définir editorPageId)."
              },
              "aiContentBlockId": {
                "type": "string",
                "description": "Pour CUSTOM_CONTENT avec contentType=\"AI\" : identifiant du bloc de contenu IA à afficher. Écrivez son HTML via PUT /content-blocks/{id}/content, puis référencez ici son identifiant."
              },
              "editorPageId": {
                "type": "string",
                "description": "Pour CUSTOM_CONTENT avec contentType=\"EDITOR\" : identifiant de la page de l’éditeur enrichi affichée dans la page."
              }
            },
            "description": "Contenu de la section. Les clés pertinentes dépendent de son `type` : HERO/HERO_STORIES lisent `slides` ; ACTIONS_GRID lit `style`+`items` ; H_CAROUSEL lit `source`+`limit`+`title` ; ANNOUNCEMENT lit `level`+`title`+`text`+`url`+`dismissible` ; *_PREVIEW et les blocs CTA lisent eyebrow/title/subtitle/description/ctaLabel/ctaUrl/limit ; CUSTOM_CONTENT lit contentType+aiContentBlockId/editorPageId."
          }
        },
        "description": "Section d’accueil mobile ou de pied de page : un `type`, des indicateurs d’affichage et un objet `props` dont les clés pertinentes dépendent du type.",
        "required": [
          "type"
        ]
      },
      "MobileExternalApp": {
        "type": "object",
        "properties": {
          "match": {
            "type": "string",
            "description": "Hôte ou fragment d’URL dont les liens s’ouvrent dans l’application native/le navigateur système plutôt que dans le navigateur intégré. Les applications courantes (Waze, Maps, WhatsApp, boutiques…) sont toujours gérées nativement et n’ont pas besoin d’être répertoriées.",
            "example": "my-partner.com"
          },
          "mode": {
            "type": "string",
            "enum": [
              "SYSTEM"
            ],
            "description": "Mode d’ouverture. Seul \"SYSTEM\" (Linking natif) est pris en charge. \"SYSTEM\" par défaut.",
            "example": "SYSTEM"
          }
        },
        "description": "Règle de routage des liens : les liens correspondant à `match` s’ouvrent nativement (mode SYSTEM).",
        "required": [
          "match"
        ]
      },
      "MobileBranding": {
        "type": "object",
        "properties": {
          "primary": {
            "type": "string",
            "description": "Couleur d’accent principale de l’application sous forme de chaîne hexadécimale. Vide/omis → teinte par défaut de l’organisation.",
            "example": "#1D4ED8"
          },
          "secondary": {
            "type": "string",
            "description": "Couleur d’accent secondaire, sous forme de chaîne hexadécimale.",
            "example": "#F59E0B"
          }
        },
        "description": "Couleurs d’accent de l’application. L’icône de l’application, l’écran de lancement et le nom dans la boutique sont figés à la compilation par le support — ils ne sont PAS modifiables ici. Seules les couleurs d’accent dans l’application peuvent être ajustées."
      },
      "MobileBottomBar": {
        "type": "object",
        "properties": {
          "visible": {
            "type": "boolean",
            "description": "Afficher la barre inférieure (false = contenu plein écran, sans barre). true par défaut."
          },
          "variant": {
            "type": "string",
            "enum": [
              "fixed",
              "floating"
            ],
            "description": "\"fixed\" (par défaut, ancrée au bord inférieur) ou \"floating\" (pastille détachée du bord).",
            "example": "fixed"
          },
          "showLabels": {
            "type": "boolean",
            "description": "Afficher le libellé textuel sous chaque icône d’onglet (false = icônes uniquement). true par défaut."
          }
        },
        "description": "Apparence de la barre d’onglets inférieure (les onglets eux-mêmes sont définis dans la section `tabs`). La masquer affiche le contenu en plein écran."
      },
      "MobileHeader": {
        "type": "object",
        "properties": {
          "visible": {
            "type": "boolean",
            "description": "Afficher l’en-tête de l’application. true par défaut."
          },
          "sticky": {
            "type": "boolean",
            "description": "true = barre de navigation fixe en haut (titre centré, format compact) ; false = en-tête intégré au défilement de la page (grand titre aligné à gauche). true par défaut."
          },
          "showBack": {
            "type": "boolean",
            "description": "Afficher la flèche de retour sur les sous-pages. true par défaut."
          },
          "title": {
            "type": "object",
            "properties": {
              "mode": {
                "type": "string",
                "enum": [
                  "SHORTNAME",
                  "CUSTOM",
                  "NONE"
                ],
                "description": "\"SHORTNAME\" = nom court/nom de l’organisation (par défaut) ; \"CUSTOM\" = `text` ci-dessous ; \"NONE\" = aucun titre.",
                "example": "SHORTNAME"
              },
              "text": {
                "type": "string",
                "description": "Texte de titre personnalisé, utilisé uniquement si mode=\"CUSTOM\" (traduisible).",
                "example": "Mon Synagogue"
              }
            },
            "description": "Configuration du titre de l’en-tête de l’application."
          },
          "actions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Identifiant généré par le serveur (uuid). Omettre à la création ; conserver lors de la modification."
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "DRAWER",
                    "URL"
                  ],
                  "description": "Type d’action. \"DRAWER\" ouvre le menu latéral (seul type entièrement opérationnel actuellement) ; \"URL\" ouvre `url`.",
                  "example": "DRAWER"
                },
                "url": {
                  "type": "string",
                  "description": "Cible de l’action, utilisée pour type=\"URL\" (chemin interne ou URL complète)."
                },
                "icon": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
                    },
                    "source": {
                      "type": "string",
                      "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
                    }
                  },
                  "description": "Icône du bouton d’action."
                },
                "label": {
                  "type": "string",
                  "description": "Libellé d’accessibilité / infobulle de l’action (traduisible). L’en-tête peut ne pas afficher le texte.",
                  "example": "Menu"
                },
                "order": {
                  "type": "number",
                  "description": "Ordre d’affichage (la valeur la plus basse en premier)."
                },
                "active": {
                  "type": "boolean",
                  "description": "Indique si l’action est affichée. true par défaut."
                },
                "fr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Libellé d’accessibilité / infobulle de l’action (traduisible). L’en-tête peut ne pas afficher le texte.",
                      "example": "Menu"
                    }
                  }
                },
                "en": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Libellé d’accessibilité / infobulle de l’action (traduisible). L’en-tête peut ne pas afficher le texte.",
                      "example": "Menu"
                    }
                  }
                },
                "he": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Libellé d’accessibilité / infobulle de l’action (traduisible). L’en-tête peut ne pas afficher le texte.",
                      "example": "Menu"
                    }
                  }
                },
                "it": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Libellé d’accessibilité / infobulle de l’action (traduisible). L’en-tête peut ne pas afficher le texte.",
                      "example": "Menu"
                    }
                  }
                },
                "ru": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Libellé d’accessibilité / infobulle de l’action (traduisible). L’en-tête peut ne pas afficher le texte.",
                      "example": "Menu"
                    }
                  }
                },
                "pt": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Libellé d’accessibilité / infobulle de l’action (traduisible). L’en-tête peut ne pas afficher le texte.",
                      "example": "Menu"
                    }
                  }
                },
                "de": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Libellé d’accessibilité / infobulle de l’action (traduisible). L’en-tête peut ne pas afficher le texte.",
                      "example": "Menu"
                    }
                  }
                },
                "es": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Libellé d’accessibilité / infobulle de l’action (traduisible). L’en-tête peut ne pas afficher le texte.",
                      "example": "Menu"
                    }
                  }
                },
                "gr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Libellé d’accessibilité / infobulle de l’action (traduisible). L’en-tête peut ne pas afficher le texte.",
                      "example": "Menu"
                    }
                  }
                },
                "ro": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "label": {
                      "type": "string",
                      "description": "Libellé d’accessibilité / infobulle de l’action (traduisible). L’en-tête peut ne pas afficher le texte.",
                      "example": "Menu"
                    }
                  }
                }
              }
            },
            "description": "Boutons d’action de l’en-tête (par ex. bouton DRAWER/menu). L’envoi de cette valeur les REMPLACE tous."
          }
        },
        "description": "Barre supérieure de l’ossature de l’application (flèche de retour + logo + titre + boutons d’action), propre à l’application mobile et distincte de l’en-tête du site. Omettez l’objet entier pour reprendre l’en-tête web habituel."
      },
      "MobileOnboarding": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Indique si le carrousel d’intégration est affiché au premier lancement. false par défaut (activation facultative)."
          },
          "version": {
            "type": "number",
            "description": "Version du carrousel (entier ≥ 1). L’augmenter réaffiche l’intégration à tous les utilisateurs.",
            "example": 1
          },
          "slides": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Identifiant généré par le serveur (uuid). Omettre à la création ; conserver lors de la modification."
                },
                "image": {
                  "type": "string",
                  "description": "Image d’arrière-plan de la diapositive (facultative). Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
                },
                "illustration": {
                  "type": "string",
                  "description": "Illustration centrale affichée sur l’arrière-plan (facultative). Image : URL http(s) (réhébergée côté serveur) ou nom de fichier \"md5.ext\" déjà hébergé."
                },
                "eyebrow_icon": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Nom de l’icône dans la bibliothèque (par ex. \"IconMapPin\")."
                    },
                    "source": {
                      "type": "string",
                      "description": "Bibliothèque d’icônes, par ex. \"tabler\"."
                    }
                  },
                  "description": "Petite icône à côté du texte introductif."
                },
                "eyebrow": {
                  "type": "string",
                  "description": "Petit texte introductif au-dessus du titre (traduisible)."
                },
                "title": {
                  "type": "string",
                  "description": "Titre de la diapositive (traduisible)."
                },
                "subtitle": {
                  "type": "string",
                  "description": "Sous-titre de la diapositive (traduisible)."
                },
                "description": {
                  "type": "string",
                  "description": "Paragraphe descriptif plus long (traduisible)."
                },
                "backgroundColor": {
                  "type": "string",
                  "description": "Couleur d’arrière-plan unie (hexadécimale), utilisée en l’absence d’image d’arrière-plan."
                },
                "textPosition": {
                  "type": "string",
                  "enum": [
                    "top",
                    "center",
                    "bottom"
                  ],
                  "description": "Position verticale du bloc de texte. \"bottom\" par défaut."
                },
                "textAlign": {
                  "type": "string",
                  "enum": [
                    "left",
                    "center",
                    "right"
                  ],
                  "description": "Alignement du texte. \"center\" par défaut."
                },
                "textColor": {
                  "type": "string",
                  "enum": [
                    "LIGHT",
                    "DARK"
                  ],
                  "description": "Palette de couleur du texte sur l’image. \"LIGHT\" par défaut."
                },
                "overlay": {
                  "type": "string",
                  "enum": [
                    "NONE",
                    "LIGHT",
                    "STRONG"
                  ],
                  "description": "Voile assombrissant l’image d’arrière-plan pour améliorer la lisibilité. \"LIGHT\" par défaut."
                },
                "fr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif au-dessus du titre (traduisible)."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre de la diapositive (traduisible)."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Sous-titre de la diapositive (traduisible)."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long (traduisible)."
                    }
                  }
                },
                "en": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif au-dessus du titre (traduisible)."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre de la diapositive (traduisible)."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Sous-titre de la diapositive (traduisible)."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long (traduisible)."
                    }
                  }
                },
                "he": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif au-dessus du titre (traduisible)."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre de la diapositive (traduisible)."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Sous-titre de la diapositive (traduisible)."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long (traduisible)."
                    }
                  }
                },
                "it": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif au-dessus du titre (traduisible)."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre de la diapositive (traduisible)."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Sous-titre de la diapositive (traduisible)."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long (traduisible)."
                    }
                  }
                },
                "ru": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif au-dessus du titre (traduisible)."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre de la diapositive (traduisible)."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Sous-titre de la diapositive (traduisible)."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long (traduisible)."
                    }
                  }
                },
                "pt": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif au-dessus du titre (traduisible)."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre de la diapositive (traduisible)."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Sous-titre de la diapositive (traduisible)."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long (traduisible)."
                    }
                  }
                },
                "de": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif au-dessus du titre (traduisible)."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre de la diapositive (traduisible)."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Sous-titre de la diapositive (traduisible)."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long (traduisible)."
                    }
                  }
                },
                "es": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif au-dessus du titre (traduisible)."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre de la diapositive (traduisible)."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Sous-titre de la diapositive (traduisible)."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long (traduisible)."
                    }
                  }
                },
                "gr": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif au-dessus du titre (traduisible)."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre de la diapositive (traduisible)."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Sous-titre de la diapositive (traduisible)."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long (traduisible)."
                    }
                  }
                },
                "ro": {
                  "type": "object",
                  "nullable": true,
                  "description": "Surcharge de traduction contenant UNIQUEMENT les champs traduisibles de cet objet pour une autre langue. La valeur dans la langue par DÉFAUT de l’organisation reste à la RACINE — elle n’est PAS imbriquée sous sa propre clé de langue. Les langues de surcharge valides sont les langues activées de l’organisation, sauf la langue par défaut (L’ÉCRITURE de la langue par défaut comme surcharge est rejetée ; son envoi à null pour SUPPRIMER une ancienne surcharge est autorisé — un changement de langue par défaut peut laisser une telle surcharge). Envoyez cet objet pour créer ou remplacer la traduction de cette langue. Définissez-le à **null** pour SUPPRIMER toute la surcharge de cette langue : omettre la clé signifie « conserver la traduction existante » lors d’une mise à jour partielle ; null est donc le SEUL moyen de la supprimer. Un objet vide ({}) est également traité comme une suppression.",
                  "properties": {
                    "eyebrow": {
                      "type": "string",
                      "description": "Petit texte introductif au-dessus du titre (traduisible)."
                    },
                    "title": {
                      "type": "string",
                      "description": "Titre de la diapositive (traduisible)."
                    },
                    "subtitle": {
                      "type": "string",
                      "description": "Sous-titre de la diapositive (traduisible)."
                    },
                    "description": {
                      "type": "string",
                      "description": "Paragraphe descriptif plus long (traduisible)."
                    }
                  }
                }
              }
            },
            "description": "Affiches d’intégration, dans l’ordre. L’envoi de cette valeur les REMPLACE toutes."
          }
        },
        "description": "Carrousel d’intégration présenté au premier lancement (quelques affiches plein écran montrées une seule fois). Les affiches ne comportent AUCUN bouton d’appel à l’action. Augmentez `version` pour le réafficher aux utilisateurs ayant déjà vu une version précédente."
      },
      "MobileAccount": {
        "type": "object",
        "properties": {
          "mode": {
            "type": "string",
            "enum": [
              "NONE",
              "OPTIONAL",
              "REQUIRED"
            ],
            "description": "\"NONE\" = ne jamais demander ; \"OPTIONAL\" = afficher une fois un écran de connexion facultatif avec possibilité de passer ; \"REQUIRED\" = écran de connexion bloquant.",
            "example": "NONE"
          },
          "version": {
            "type": "number",
            "description": "Version du contrôle d’accès (entier ≥ 1). L’augmenter réaffiche l’écran de connexion.",
            "example": 1
          }
        },
        "description": "Indique si l’application demande à l’utilisateur de se connecter à l’espace de compte après l’intégration. Pris en compte uniquement lorsque l’espace de compte est disponible (domaine personnalisé + AccountSpace activé) — sinon, l’application revient gracieusement à NONE."
      },
      "MobileInitialUrl": {
        "type": "object",
        "properties": {
          "initialUrl": {
            "type": "string",
            "description": "URL de démarrage : chemin interne (\"/accueil-app\") ou URL complète. Vide = déduite automatiquement du domaine de l’organisation.",
            "example": "/accueil-app"
          }
        },
        "description": "URL exacte vers laquelle l’application navigue au démarrage (page d’accueil propre à l’application, pouvant différer de celle du site web). Laissez `initialUrl` vide pour laisser l’application déduire l’URL du site depuis le domaine/préfixe de l’organisation."
      },
      "MobileMeta": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "description": "Libellé interne de cette configuration d’application.",
            "example": "App Beth Habad"
          },
          "active": {
            "type": "boolean",
            "description": "Indique si cette configuration est active. Si false, l’application publique cesse de la résoudre."
          }
        },
        "description": "Métadonnées du cycle de vie de la configuration de l’application (stockées à la racine du document, hors de `config`). Envoyez le ou les champs à modifier."
      },
      "MobileDistribution": {
        "type": "object",
        "description": "Identité de la boutique et schéma de liens profonds. LECTURE SEULE (définis par le support lors du provisionnement ; utilisés pour les fichiers .well-known apple-app-site-association / assetlinks.json).",
        "properties": {
          "appleTeamId": {
            "type": "string",
            "nullable": true,
            "example": "8H6H98VTLH",
            "description": "Identifiant d’équipe Apple Developer (10 caractères) de l’application. Utilisé pour la signature iOS et les Universal Links."
          },
          "iosBundleId": {
            "type": "string",
            "nullable": true,
            "example": "com.org.app",
            "description": "Identifiant de bundle iOS (DNS inversé, unique dans l’App Store)."
          },
          "appStoreId": {
            "type": "string",
            "nullable": true,
            "example": "1234567890",
            "description": "Identifiant numérique App Store (utilisé dans les liens vers la boutique)."
          },
          "androidPackage": {
            "type": "string",
            "nullable": true,
            "example": "com.org.app",
            "description": "applicationId/nom de package Android (DNS inversé, unique dans le Play Store)."
          },
          "androidSha256": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Empreintes SHA-256 des clés de signature Android, pour les App Links (assetlinks.json)."
          },
          "deepLinkScheme": {
            "type": "string",
            "nullable": true,
            "example": "unisoft_mobile",
            "description": "Schéma d’URL personnalisé de l’application (par ex. \"unisoft_mobile\" → unisoft_mobile://), utilisé pour les liens profonds directs (retour de paiement externe, OAuth)."
          }
        }
      },
      "MobileConfigBody": {
        "type": "object",
        "description": "Couche de configuration modifiable de l’application mobile.",
        "properties": {
          "branding": {
            "$ref": "#/components/schemas/MobileBranding"
          },
          "bottomBar": {
            "$ref": "#/components/schemas/MobileBottomBar"
          },
          "tabs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MobileTab"
            }
          },
          "header": {
            "$ref": "#/components/schemas/MobileHeader"
          },
          "onboarding": {
            "$ref": "#/components/schemas/MobileOnboarding"
          },
          "account": {
            "$ref": "#/components/schemas/MobileAccount"
          },
          "initialUrl": {
            "type": "string",
            "description": "URL de démarrage de l’application (chemin interne ou URL complète ; vide = déduite du domaine de l’organisation)."
          },
          "externalApps": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "match": {
                  "type": "string",
                  "description": "Hôte ou fragment d’URL dont les liens s’ouvrent dans l’application native/le navigateur système plutôt que dans le navigateur intégré. Les applications courantes (Waze, Maps, WhatsApp, boutiques…) sont toujours gérées nativement et n’ont pas besoin d’être répertoriées.",
                  "example": "my-partner.com"
                },
                "mode": {
                  "type": "string",
                  "enum": [
                    "SYSTEM"
                  ],
                  "description": "Mode d’ouverture. Seul \"SYSTEM\" (Linking natif) est pris en charge. \"SYSTEM\" par défaut.",
                  "example": "SYSTEM"
                }
              },
              "required": [
                "match"
              ]
            },
            "description": "Règles de routage des liens : quels liens externes s’ouvrent nativement."
          },
          "sections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MobileSection"
            }
          },
          "preFooterSections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MobileSection"
            }
          }
        }
      },
      "MobileConfig": {
        "type": "object",
        "description": "Configuration de marque blanche de l’application mobile d’une façade. `config` est la couche modifiable ; `distribution` et `knownHosts` sont les éléments d’identité/sécurité définis par le support et accessibles en lecture seule.",
        "properties": {
          "organisation": {
            "type": "string",
            "readOnly": true,
            "description": "Identifiant de l’organisation propriétaire."
          },
          "virtualId": {
            "type": "string",
            "nullable": true,
            "readOnly": true,
            "description": "Identifiant de la façade. null = application principale."
          },
          "label": {
            "type": "string",
            "description": "Libellé interne de cette configuration d’application."
          },
          "active": {
            "type": "boolean",
            "description": "Indique si cette configuration est active."
          },
          "config": {
            "$ref": "#/components/schemas/MobileConfigBody"
          },
          "distribution": {
            "allOf": [
              {
                "$ref": "#/components/schemas/MobileDistribution"
              }
            ],
            "readOnly": true
          },
          "knownHosts": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "readOnly": true,
            "description": "Hôtes qui restent dans la WebView (paramètre réservé au support)."
          }
        }
      },
      "MobileFacade": {
        "type": "object",
        "description": "Une façade = une application mobile de l’organisation. L’application principale a virtualId=null ; chaque application virtuelle possède son propre identifiant.",
        "properties": {
          "virtualId": {
            "type": "string",
            "nullable": true,
            "description": "Transmettez cette valeur via `?virtualId=` pour cibler la façade. null = application principale."
          },
          "label": {
            "type": "string",
            "description": "Libellé lisible de la façade (nom de l’organisation/du site)."
          }
        }
      },
      "AnnualEventDestination": {
        "type": "object",
        "additionalProperties": false,
        "description": "Destination de l’événement. Utilisez `existing` uniquement après avoir listé et explicitement sélectionné un groupe standard compatible ; les groupes protégés ou à sessions multiples sont refusés.",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "new",
              "existing"
            ],
            "default": "new"
          },
          "groupId": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant d’un groupe standard existant et autonome."
          },
          "groupLabel": {
            "type": "string",
            "maxLength": 500
          },
          "confirmed": {
            "type": "boolean",
            "description": "Doit être true : l’appelant confirme la décision de destination."
          }
        },
        "required": [
          "kind",
          "confirmed"
        ]
      },
      "AnnualEventTariff": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 100
          },
          "label": {
            "type": "string",
            "maxLength": 300
          },
          "price": {
            "type": "number",
            "minimum": 0
          },
          "prices": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "minimum": 0
            },
            "description": "Prix facultatifs indexés par devise secondaire activée (code ISO en minuscules). Les valeurs manquantes conservent le prix numérique principal sans conversion."
          },
          "stock": {
            "type": "integer",
            "minimum": 0,
            "nullable": true
          }
        },
        "required": [
          "label",
          "price"
        ]
      },
      "AnnualEventQuestion": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 100
          },
          "label": {
            "type": "string",
            "maxLength": 500
          },
          "type": {
            "type": "string",
            "enum": [
              "shortText",
              "longText",
              "yesNo",
              "choice",
              "document"
            ]
          },
          "required": {
            "type": "boolean"
          },
          "options": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string",
              "maxLength": 300
            }
          },
          "condition": {
            "type": "object",
            "nullable": true,
            "additionalProperties": false,
            "properties": {
              "questionId": {
                "type": "string"
              },
              "value": {
                "type": "string"
              }
            },
            "required": [
              "questionId",
              "value"
            ]
          }
        },
        "required": [
          "label",
          "type"
        ]
      },
      "AnnualEventRequirement": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string"
          },
          "label": {
            "type": "string",
            "maxLength": 500
          },
          "required": {
            "type": "boolean"
          }
        },
        "required": [
          "label"
        ]
      },
      "AnnualEventDraft": {
        "type": "object",
        "additionalProperties": false,
        "description": "Recette complète d’événement. Le serveur normalise cet objet et crée toutes les ressources demandées. Les montants sont en unités majeures de la devise. Une affiche `upload` est une véritable image ; transmettez soit un nom de fichier hébergé de `/uploads/image`, soit une URL http(s) que le serveur peut réhéberger.",
        "properties": {
          "id": {
            "type": "string",
            "nullable": true,
            "description": "UUID facultatif du projet. Omettre à la création ; conserver lors des mises à jour."
          },
          "version": {
            "type": "integer",
            "minimum": 1,
            "default": 1
          },
          "templateId": {
            "type": "string",
            "description": "Identifiant de format suggéré, ou `custom`."
          },
          "destination": {
            "$ref": "#/components/schemas/AnnualEventDestination"
          },
          "capabilities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string",
            "minLength": 3,
            "maxLength": 500
          },
          "sourceLanguage": {
            "type": "string",
            "description": "Langue du contenu fourni ; par défaut, langue de l’organisation. Les organisations multilingues reçoivent automatiquement des traductions du contenu à la création."
          },
          "currency": {
            "type": "string",
            "readOnly": true,
            "description": "Devise principale déterminée par le serveur à partir de l’organisation."
          },
          "tagline": {
            "type": "string",
            "maxLength": 2000
          },
          "description": {
            "type": "string",
            "maxLength": 20000
          },
          "mode": {
            "type": "string",
            "enum": [
              "registration",
              "fundraising",
              "both",
              "information"
            ]
          },
          "attendeeMode": {
            "type": "string",
            "enum": [
              "individual",
              "group",
              "family",
              "children"
            ]
          },
          "date": {
            "type": "string",
            "format": "date",
            "description": "Obligatoire sauf pour une collecte autonome sans date obligatoire."
          },
          "dateOptional": {
            "type": "boolean"
          },
          "startTime": {
            "type": "string",
            "pattern": "^[0-2][0-9]:[0-5][0-9]$"
          },
          "endTime": {
            "type": "string",
            "pattern": "^[0-2][0-9]:[0-5][0-9]$"
          },
          "locationMode": {
            "type": "string",
            "enum": [
              "onsite",
              "online"
            ]
          },
          "locationName": {
            "type": "string",
            "maxLength": 500
          },
          "address": {
            "type": "string",
            "maxLength": 1000
          },
          "onlineUrl": {
            "type": "string",
            "format": "uri"
          },
          "cadence": {
            "type": "string",
            "enum": [
              "once",
              "weekly",
              "monthly",
              "custom"
            ]
          },
          "recurrenceCount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 200
          },
          "customDates": {
            "type": "array",
            "maxItems": 200,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "date"
            },
            "description": "Toutes les dates de session lorsque cadence=custom. La première date et le nombre sont déduits de cette liste."
          },
          "excludedDates": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string",
              "format": "date"
            }
          },
          "slotDuration": {
            "type": "integer",
            "minimum": 0
          },
          "slotCapacity": {
            "type": "integer",
            "minimum": 0
          },
          "capacityEnabled": {
            "type": "boolean"
          },
          "capacity": {
            "type": "integer",
            "minimum": 0
          },
          "priceMode": {
            "type": "string",
            "enum": [
              "free",
              "fixed",
              "multiple",
              "freeAmount"
            ]
          },
          "price": {
            "type": "number",
            "minimum": 0
          },
          "prices": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "minimum": 0
            },
            "description": "Prix facultatifs indexés par devise secondaire activée (code ISO en minuscules). Les valeurs manquantes conservent le prix numérique principal sans conversion."
          },
          "tariffs": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/AnnualEventTariff"
            }
          },
          "target": {
            "type": "number",
            "minimum": 0
          },
          "partialPayments": {
            "type": "boolean"
          },
          "depositAmount": {
            "type": "number",
            "minimum": 0
          },
          "contributionAmounts": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "number",
              "minimum": 0
            }
          },
          "fields": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "firstName",
                "lastName",
                "email",
                "phone",
                "address",
                "birthDate"
              ]
            }
          },
          "children": {
            "type": "boolean"
          },
          "questions": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/AnnualEventQuestion"
            }
          },
          "requirementsEnabled": {
            "type": "boolean"
          },
          "requirements": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/AnnualEventRequirement"
            }
          },
          "manualValidation": {
            "type": "boolean"
          },
          "confirmationText": {
            "type": "string",
            "maxLength": 5000
          },
          "reminders": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "confirmation": {
                "type": "boolean"
              },
              "weekBefore": {
                "type": "boolean"
              },
              "dayBefore": {
                "type": "boolean"
              }
            }
          },
          "page": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "layout": {
                "type": "string",
                "enum": [
                  "essential",
                  "story",
                  "campaign"
                ]
              },
              "ctaLabel": {
                "type": "string",
                "maxLength": 300
              },
              "showDescription": {
                "type": "boolean"
              },
              "showPracticalInfo": {
                "type": "boolean"
              },
              "showOrganizer": {
                "type": "boolean"
              },
              "showProgress": {
                "type": "boolean"
              },
              "customContent": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "faq",
                      "pricing",
                      "programme",
                      "speakers",
                      "free"
                    ]
                  },
                  "aiContentBlockId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Identifiant existant de bloc de contenu IA. Gérez son HTML via `/content-blocks`."
                  }
                }
              }
            }
          },
          "poster": {
            "type": "object",
            "additionalProperties": false,
            "description": "Une affiche n’existe que lorsque `source=upload` et que `image` référence une véritable image.",
            "properties": {
              "source": {
                "type": "string",
                "enum": [
                  "none",
                  "upload"
                ]
              },
              "image": {
                "type": "string",
                "nullable": true,
                "description": "Nom de fichier hébergé ou URL d’image http(s)."
              },
              "tone": {
                "type": "string",
                "enum": [
                  "auto",
                  "blue",
                  "cyan",
                  "violet",
                  "green",
                  "amber",
                  "rose",
                  "red"
                ],
                "description": "\"auto\" suit le thème du site public ; les couleurs explicites restent fixes."
              },
              "badge": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "campaignEnabled": {
            "type": "boolean",
            "description": "Lorsque true, créer ou mettre à jour un brouillon de campagne ; il n’est jamais envoyé automatiquement."
          },
          "campaign": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "channels": {
                "type": "array",
                "minItems": 1,
                "maxItems": 3,
                "items": {
                  "type": "string",
                  "enum": [
                    "email",
                    "whatsapp",
                    "sms"
                  ]
                }
              },
              "audience": {
                "type": "string",
                "enum": [
                  "all",
                  "families",
                  "participants",
                  "custom"
                ],
                "description": "`families`, `participants` et `custom` conservent le brouillon sans ciblage automatique, jusqu’à ce que l’organisateur choisisse l’audience exacte."
              },
              "includePoster": {
                "type": "boolean",
                "description": "L’image est jointe uniquement si une véritable affiche téléversée existe."
              },
              "message": {
                "type": "string",
                "maxLength": 10000
              },
              "schedule": {
                "type": "string",
                "enum": [
                  "now",
                  "later"
                ]
              },
              "scheduledAt": {
                "type": "string",
                "nullable": true,
                "description": "Date et heure ISO utilisées lorsque la campagne sera finalement envoyée."
              }
            }
          },
          "posterAnalysis": {
            "type": "object",
            "nullable": true,
            "additionalProperties": false,
            "description": "Métadonnées d’audit conservées lorsque le brouillon a été préparé à partir d’une affiche.",
            "properties": {
              "confidence": {
                "type": "string",
                "enum": [
                  "high",
                  "medium",
                  "low"
                ]
              },
              "detectedLanguage": {
                "type": "string"
              },
              "sourceSummary": {
                "type": "string"
              },
              "extractedText": {
                "type": "string"
              },
              "warnings": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "analyzedAt": {
                "type": "string"
              }
            }
          },
          "draftStatus": {
            "type": "string",
            "enum": [
              "EDITING",
              "READY"
            ]
          },
          "validatedAt": {
            "type": "string",
            "nullable": true
          },
          "cursorStepId": {
            "type": "string"
          }
        },
        "required": [
          "title",
          "destination",
          "mode"
        ]
      },
      "AnnualEventResources": {
        "type": "object",
        "properties": {
          "groupId": {
            "type": "string",
            "nullable": true
          },
          "sessionIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "formIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "fundraiserIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "campaignIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "AnnualEventRegistrationState": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "configured": {
            "type": "boolean",
            "description": "Indique si au moins un formulaire d’inscription géré existe."
          },
          "open": {
            "type": "boolean",
            "description": "Indique si un formulaire géré et l’une des sessions de son événement sont actuellement actifs."
          },
          "submissionCount": {
            "type": "integer",
            "minimum": 0,
            "description": "Inscriptions reçues, non archivées et à l’état SUBMIT ou VALIDE."
          }
        },
        "required": [
          "configured",
          "open",
          "submissionCount"
        ]
      },
      "AnnualEventOperationalState": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "registration": {
            "$ref": "#/components/schemas/AnnualEventRegistrationState"
          }
        },
        "required": [
          "registration"
        ]
      },
      "AnnualEventCompatibleGroup": {
        "type": "object",
        "additionalProperties": false,
        "description": "Groupe standard à session unique pouvant accueillir un nouvel événement.",
        "properties": {
          "id": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "image": {
            "type": "string",
            "nullable": true
          },
          "mode": {
            "type": "string",
            "enum": [
              "STANDALONE"
            ]
          }
        },
        "required": [
          "id",
          "label",
          "mode"
        ]
      },
      "AnnualEventPublishResult": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "eventId": {
            "type": "string"
          },
          "projectId": {
            "type": "string"
          },
          "revision": {
            "type": "integer"
          },
          "publicationStatus": {
            "type": "string",
            "enum": [
              "CREATED",
              "PUBLISHED",
              "PUBLISHING",
              "PUBLISH_FAILED"
            ]
          },
          "publishedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "publicUrl": {
            "type": "string",
            "nullable": true
          },
          "resources": {
            "$ref": "#/components/schemas/AnnualEventResources"
          },
          "operationalState": {
            "$ref": "#/components/schemas/AnnualEventOperationalState"
          }
        }
      },
      "AnnualEventProject": {
        "allOf": [
          {
            "$ref": "#/components/schemas/AnnualEventPublishResult"
          },
          {
            "type": "object",
            "properties": {
              "draft": {
                "$ref": "#/components/schemas/AnnualEventDraft"
              },
              "snapshotHash": {
                "type": "string"
              },
              "datetime": {
                "type": "string",
                "format": "date-time"
              },
              "updatedAt": {
                "type": "string",
                "format": "date-time"
              }
            }
          }
        ]
      },
      "AnnualEventPosterAnalysisRequest": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "poster": {
            "type": "string",
            "description": "Nom de fichier image hébergé provenant de `/uploads/image`, ou URL http(s) à réhéberger au préalable."
          }
        },
        "required": [
          "poster"
        ]
      },
      "AnnualEventPosterAnalysis": {
        "type": "object",
        "description": "Brouillon d’événement suggéré à partir de l’affiche. Chaque champ peut être vérifié avant publication.",
        "properties": {
          "analysis": {
            "type": "object",
            "properties": {
              "detectedLanguage": {
                "type": "string"
              },
              "confidence": {
                "type": "string",
                "enum": [
                  "high",
                  "medium",
                  "low"
                ]
              },
              "sourceSummary": {
                "type": "string"
              },
              "extractedText": {
                "type": "string"
              },
              "warnings": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "event": {
            "type": "object",
            "description": "Suggestion brute, fondée sur les éléments visuels, renvoyée par le modèle d’affiche. Préférez `draft`, déjà converti au contrat canonique de création.",
            "additionalProperties": true
          },
          "poster": {
            "type": "object",
            "properties": {
              "source": {
                "type": "string"
              },
              "image": {
                "type": "string"
              }
            }
          },
          "draft": {
            "$ref": "#/components/schemas/AnnualEventDraft"
          }
        }
      },
      "AnnualEventCreateInput": {
        "type": "object",
        "additionalProperties": false,
        "description": "Recette complète d’événement. Le serveur normalise cet objet et crée toutes les ressources demandées. Les montants sont en unités majeures de la devise. Une affiche `upload` est une véritable image ; transmettez soit un nom de fichier hébergé de `/uploads/image`, soit une URL http(s) que le serveur peut réhéberger.",
        "properties": {
          "id": {
            "type": "string",
            "nullable": true,
            "description": "UUID facultatif du projet. Omettre à la création ; conserver lors des mises à jour."
          },
          "version": {
            "type": "integer",
            "minimum": 1,
            "default": 1
          },
          "templateId": {
            "type": "string",
            "description": "Identifiant de format suggéré, ou `custom`."
          },
          "destination": {
            "$ref": "#/components/schemas/AnnualEventDestination"
          },
          "capabilities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string",
            "minLength": 3,
            "maxLength": 500
          },
          "sourceLanguage": {
            "type": "string",
            "description": "Langue du contenu fourni ; par défaut, langue de l’organisation. Les organisations multilingues reçoivent automatiquement des traductions du contenu à la création."
          },
          "currency": {
            "type": "string",
            "readOnly": true,
            "description": "Devise principale déterminée par le serveur à partir de l’organisation."
          },
          "tagline": {
            "type": "string",
            "maxLength": 2000
          },
          "description": {
            "type": "string",
            "maxLength": 20000
          },
          "mode": {
            "type": "string",
            "enum": [
              "registration",
              "fundraising",
              "both",
              "information"
            ]
          },
          "attendeeMode": {
            "type": "string",
            "enum": [
              "individual",
              "group",
              "family",
              "children"
            ]
          },
          "date": {
            "type": "string",
            "format": "date",
            "description": "Obligatoire sauf pour une collecte autonome sans date obligatoire."
          },
          "dateOptional": {
            "type": "boolean"
          },
          "startTime": {
            "type": "string",
            "pattern": "^[0-2][0-9]:[0-5][0-9]$"
          },
          "endTime": {
            "type": "string",
            "pattern": "^[0-2][0-9]:[0-5][0-9]$"
          },
          "locationMode": {
            "type": "string",
            "enum": [
              "onsite",
              "online"
            ]
          },
          "locationName": {
            "type": "string",
            "maxLength": 500
          },
          "address": {
            "type": "string",
            "maxLength": 1000
          },
          "onlineUrl": {
            "type": "string",
            "format": "uri"
          },
          "cadence": {
            "type": "string",
            "enum": [
              "once",
              "weekly",
              "monthly",
              "custom"
            ]
          },
          "recurrenceCount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 200
          },
          "customDates": {
            "type": "array",
            "maxItems": 200,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "date"
            },
            "description": "Toutes les dates de session lorsque cadence=custom. La première date et le nombre sont déduits de cette liste."
          },
          "excludedDates": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string",
              "format": "date"
            }
          },
          "slotDuration": {
            "type": "integer",
            "minimum": 0
          },
          "slotCapacity": {
            "type": "integer",
            "minimum": 0
          },
          "capacityEnabled": {
            "type": "boolean"
          },
          "capacity": {
            "type": "integer",
            "minimum": 0
          },
          "priceMode": {
            "type": "string",
            "enum": [
              "free",
              "fixed",
              "multiple",
              "freeAmount"
            ]
          },
          "price": {
            "type": "number",
            "minimum": 0
          },
          "prices": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "minimum": 0
            },
            "description": "Prix facultatifs indexés par devise secondaire activée (code ISO en minuscules). Les valeurs manquantes conservent le prix numérique principal sans conversion."
          },
          "tariffs": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/AnnualEventTariff"
            }
          },
          "target": {
            "type": "number",
            "minimum": 0
          },
          "partialPayments": {
            "type": "boolean"
          },
          "depositAmount": {
            "type": "number",
            "minimum": 0
          },
          "contributionAmounts": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "number",
              "minimum": 0
            }
          },
          "fields": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "firstName",
                "lastName",
                "email",
                "phone",
                "address",
                "birthDate"
              ]
            }
          },
          "children": {
            "type": "boolean"
          },
          "questions": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/AnnualEventQuestion"
            }
          },
          "requirementsEnabled": {
            "type": "boolean"
          },
          "requirements": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/AnnualEventRequirement"
            }
          },
          "manualValidation": {
            "type": "boolean"
          },
          "confirmationText": {
            "type": "string",
            "maxLength": 5000
          },
          "reminders": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "confirmation": {
                "type": "boolean"
              },
              "weekBefore": {
                "type": "boolean"
              },
              "dayBefore": {
                "type": "boolean"
              }
            }
          },
          "page": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "layout": {
                "type": "string",
                "enum": [
                  "essential",
                  "story",
                  "campaign"
                ]
              },
              "ctaLabel": {
                "type": "string",
                "maxLength": 300
              },
              "showDescription": {
                "type": "boolean"
              },
              "showPracticalInfo": {
                "type": "boolean"
              },
              "showOrganizer": {
                "type": "boolean"
              },
              "showProgress": {
                "type": "boolean"
              },
              "customContent": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "faq",
                      "pricing",
                      "programme",
                      "speakers",
                      "free"
                    ]
                  },
                  "aiContentBlockId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Identifiant existant de bloc de contenu IA. Gérez son HTML via `/content-blocks`."
                  }
                }
              }
            }
          },
          "poster": {
            "type": "object",
            "additionalProperties": false,
            "description": "Une affiche n’existe que lorsque `source=upload` et que `image` référence une véritable image.",
            "properties": {
              "source": {
                "type": "string",
                "enum": [
                  "none",
                  "upload"
                ]
              },
              "image": {
                "type": "string",
                "nullable": true,
                "description": "Nom de fichier hébergé ou URL d’image http(s)."
              },
              "tone": {
                "type": "string",
                "enum": [
                  "auto",
                  "blue",
                  "cyan",
                  "violet",
                  "green",
                  "amber",
                  "rose",
                  "red"
                ],
                "description": "\"auto\" suit le thème du site public ; les couleurs explicites restent fixes."
              },
              "badge": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "campaignEnabled": {
            "type": "boolean",
            "description": "Lorsque true, créer ou mettre à jour un brouillon de campagne ; il n’est jamais envoyé automatiquement."
          },
          "campaign": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "channels": {
                "type": "array",
                "minItems": 1,
                "maxItems": 3,
                "items": {
                  "type": "string",
                  "enum": [
                    "email",
                    "whatsapp",
                    "sms"
                  ]
                }
              },
              "audience": {
                "type": "string",
                "enum": [
                  "all",
                  "families",
                  "participants",
                  "custom"
                ],
                "description": "`families`, `participants` et `custom` conservent le brouillon sans ciblage automatique, jusqu’à ce que l’organisateur choisisse l’audience exacte."
              },
              "includePoster": {
                "type": "boolean",
                "description": "L’image est jointe uniquement si une véritable affiche téléversée existe."
              },
              "message": {
                "type": "string",
                "maxLength": 10000
              },
              "schedule": {
                "type": "string",
                "enum": [
                  "now",
                  "later"
                ]
              },
              "scheduledAt": {
                "type": "string",
                "nullable": true,
                "description": "Date et heure ISO utilisées lorsque la campagne sera finalement envoyée."
              }
            }
          },
          "posterAnalysis": {
            "type": "object",
            "nullable": true,
            "additionalProperties": false,
            "description": "Métadonnées d’audit conservées lorsque le brouillon a été préparé à partir d’une affiche.",
            "properties": {
              "confidence": {
                "type": "string",
                "enum": [
                  "high",
                  "medium",
                  "low"
                ]
              },
              "detectedLanguage": {
                "type": "string"
              },
              "sourceSummary": {
                "type": "string"
              },
              "extractedText": {
                "type": "string"
              },
              "warnings": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "analyzedAt": {
                "type": "string"
              }
            }
          },
          "draftStatus": {
            "type": "string",
            "enum": [
              "EDITING",
              "READY"
            ]
          },
          "validatedAt": {
            "type": "string",
            "nullable": true
          },
          "cursorStepId": {
            "type": "string"
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "timeZone": {
            "type": "string"
          }
        },
        "required": [
          "title",
          "destination",
          "mode",
          "idempotencyKey"
        ]
      },
      "AnnualEventPatch": {
        "type": "object",
        "additionalProperties": false,
        "description": "Recette complète d’événement. Le serveur normalise cet objet et crée toutes les ressources demandées. Les montants sont en unités majeures de la devise. Une affiche `upload` est une véritable image ; transmettez soit un nom de fichier hébergé de `/uploads/image`, soit une URL http(s) que le serveur peut réhéberger.",
        "properties": {
          "id": {
            "type": "string",
            "nullable": true,
            "description": "UUID facultatif du projet. Omettre à la création ; conserver lors des mises à jour."
          },
          "version": {
            "type": "integer",
            "minimum": 1,
            "default": 1
          },
          "templateId": {
            "type": "string",
            "description": "Identifiant de format suggéré, ou `custom`."
          },
          "destination": {
            "$ref": "#/components/schemas/AnnualEventDestination"
          },
          "capabilities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string",
            "minLength": 3,
            "maxLength": 500
          },
          "sourceLanguage": {
            "type": "string",
            "description": "Langue du contenu fourni ; par défaut, langue de l’organisation. Les organisations multilingues reçoivent automatiquement des traductions du contenu à la création."
          },
          "currency": {
            "type": "string",
            "readOnly": true,
            "description": "Devise principale déterminée par le serveur à partir de l’organisation."
          },
          "tagline": {
            "type": "string",
            "maxLength": 2000
          },
          "description": {
            "type": "string",
            "maxLength": 20000
          },
          "mode": {
            "type": "string",
            "enum": [
              "registration",
              "fundraising",
              "both",
              "information"
            ]
          },
          "attendeeMode": {
            "type": "string",
            "enum": [
              "individual",
              "group",
              "family",
              "children"
            ]
          },
          "date": {
            "type": "string",
            "format": "date",
            "description": "Obligatoire sauf pour une collecte autonome sans date obligatoire."
          },
          "dateOptional": {
            "type": "boolean"
          },
          "startTime": {
            "type": "string",
            "pattern": "^[0-2][0-9]:[0-5][0-9]$"
          },
          "endTime": {
            "type": "string",
            "pattern": "^[0-2][0-9]:[0-5][0-9]$"
          },
          "locationMode": {
            "type": "string",
            "enum": [
              "onsite",
              "online"
            ]
          },
          "locationName": {
            "type": "string",
            "maxLength": 500
          },
          "address": {
            "type": "string",
            "maxLength": 1000
          },
          "onlineUrl": {
            "type": "string",
            "format": "uri"
          },
          "cadence": {
            "type": "string",
            "enum": [
              "once",
              "weekly",
              "monthly",
              "custom"
            ]
          },
          "recurrenceCount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 200
          },
          "customDates": {
            "type": "array",
            "maxItems": 200,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "date"
            },
            "description": "Toutes les dates de session lorsque cadence=custom. La première date et le nombre sont déduits de cette liste."
          },
          "excludedDates": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string",
              "format": "date"
            }
          },
          "slotDuration": {
            "type": "integer",
            "minimum": 0
          },
          "slotCapacity": {
            "type": "integer",
            "minimum": 0
          },
          "capacityEnabled": {
            "type": "boolean"
          },
          "capacity": {
            "type": "integer",
            "minimum": 0
          },
          "priceMode": {
            "type": "string",
            "enum": [
              "free",
              "fixed",
              "multiple",
              "freeAmount"
            ]
          },
          "price": {
            "type": "number",
            "minimum": 0
          },
          "prices": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "minimum": 0
            },
            "description": "Prix facultatifs indexés par devise secondaire activée (code ISO en minuscules). Les valeurs manquantes conservent le prix numérique principal sans conversion."
          },
          "tariffs": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/AnnualEventTariff"
            }
          },
          "target": {
            "type": "number",
            "minimum": 0
          },
          "partialPayments": {
            "type": "boolean"
          },
          "depositAmount": {
            "type": "number",
            "minimum": 0
          },
          "contributionAmounts": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "number",
              "minimum": 0
            }
          },
          "fields": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "firstName",
                "lastName",
                "email",
                "phone",
                "address",
                "birthDate"
              ]
            }
          },
          "children": {
            "type": "boolean"
          },
          "questions": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/AnnualEventQuestion"
            }
          },
          "requirementsEnabled": {
            "type": "boolean"
          },
          "requirements": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/AnnualEventRequirement"
            }
          },
          "manualValidation": {
            "type": "boolean"
          },
          "confirmationText": {
            "type": "string",
            "maxLength": 5000
          },
          "reminders": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "confirmation": {
                "type": "boolean"
              },
              "weekBefore": {
                "type": "boolean"
              },
              "dayBefore": {
                "type": "boolean"
              }
            }
          },
          "page": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "layout": {
                "type": "string",
                "enum": [
                  "essential",
                  "story",
                  "campaign"
                ]
              },
              "ctaLabel": {
                "type": "string",
                "maxLength": 300
              },
              "showDescription": {
                "type": "boolean"
              },
              "showPracticalInfo": {
                "type": "boolean"
              },
              "showOrganizer": {
                "type": "boolean"
              },
              "showProgress": {
                "type": "boolean"
              },
              "customContent": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "faq",
                      "pricing",
                      "programme",
                      "speakers",
                      "free"
                    ]
                  },
                  "aiContentBlockId": {
                    "type": "string",
                    "nullable": true,
                    "description": "Identifiant existant de bloc de contenu IA. Gérez son HTML via `/content-blocks`."
                  }
                }
              }
            }
          },
          "poster": {
            "type": "object",
            "additionalProperties": false,
            "description": "Une affiche n’existe que lorsque `source=upload` et que `image` référence une véritable image.",
            "properties": {
              "source": {
                "type": "string",
                "enum": [
                  "none",
                  "upload"
                ]
              },
              "image": {
                "type": "string",
                "nullable": true,
                "description": "Nom de fichier hébergé ou URL d’image http(s)."
              },
              "tone": {
                "type": "string",
                "enum": [
                  "auto",
                  "blue",
                  "cyan",
                  "violet",
                  "green",
                  "amber",
                  "rose",
                  "red"
                ],
                "description": "\"auto\" suit le thème du site public ; les couleurs explicites restent fixes."
              },
              "badge": {
                "type": "string",
                "maxLength": 300
              }
            }
          },
          "campaignEnabled": {
            "type": "boolean",
            "description": "Lorsque true, créer ou mettre à jour un brouillon de campagne ; il n’est jamais envoyé automatiquement."
          },
          "campaign": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "channels": {
                "type": "array",
                "minItems": 1,
                "maxItems": 3,
                "items": {
                  "type": "string",
                  "enum": [
                    "email",
                    "whatsapp",
                    "sms"
                  ]
                }
              },
              "audience": {
                "type": "string",
                "enum": [
                  "all",
                  "families",
                  "participants",
                  "custom"
                ],
                "description": "`families`, `participants` et `custom` conservent le brouillon sans ciblage automatique, jusqu’à ce que l’organisateur choisisse l’audience exacte."
              },
              "includePoster": {
                "type": "boolean",
                "description": "L’image est jointe uniquement si une véritable affiche téléversée existe."
              },
              "message": {
                "type": "string",
                "maxLength": 10000
              },
              "schedule": {
                "type": "string",
                "enum": [
                  "now",
                  "later"
                ]
              },
              "scheduledAt": {
                "type": "string",
                "nullable": true,
                "description": "Date et heure ISO utilisées lorsque la campagne sera finalement envoyée."
              }
            }
          },
          "posterAnalysis": {
            "type": "object",
            "nullable": true,
            "additionalProperties": false,
            "description": "Métadonnées d’audit conservées lorsque le brouillon a été préparé à partir d’une affiche.",
            "properties": {
              "confidence": {
                "type": "string",
                "enum": [
                  "high",
                  "medium",
                  "low"
                ]
              },
              "detectedLanguage": {
                "type": "string"
              },
              "sourceSummary": {
                "type": "string"
              },
              "extractedText": {
                "type": "string"
              },
              "warnings": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "analyzedAt": {
                "type": "string"
              }
            }
          },
          "draftStatus": {
            "type": "string",
            "enum": [
              "EDITING",
              "READY"
            ]
          },
          "validatedAt": {
            "type": "string",
            "nullable": true
          },
          "cursorStepId": {
            "type": "string"
          }
        },
        "required": []
      },
      "FundraisingCampaign": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 120
          },
          "url": {
            "type": "string",
            "maxLength": 60,
            "pattern": "^campaign-[a-z0-9][a-z0-9-]{0,49}[a-z0-9]$"
          },
          "type": {
            "type": "string",
            "enum": [
              "AMOUNT",
              "COUNT",
              "PARTNER"
            ]
          },
          "objectif": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 1000000000,
            "multipleOf": 0.01
          },
          "matched": {
            "type": "number",
            "minimum": 1,
            "maximum": 100
          },
          "partnerMontant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "dateStart": {
            "type": "string",
            "maxLength": 40,
            "format": "date-time",
            "nullable": true
          },
          "dateEnd": {
            "type": "string",
            "maxLength": 40,
            "format": "date-time",
            "nullable": true
          },
          "donationPolicy": {
            "type": "string",
            "enum": [
              "OPEN",
              "SCHEDULED"
            ]
          },
          "bonus": {
            "type": "array",
            "items": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 10000000,
              "multipleOf": 0.01
            },
            "maxItems": 30
          },
          "gala": {
            "type": "boolean"
          },
          "ambs": {
            "type": "boolean"
          },
          "stockable": {
            "type": "boolean"
          },
          "tombola": {
            "type": "boolean",
            "deprecated": true,
            "description": "Alias historique de stockable. Conservé en lecture pour compatibilité ; utilisez stockable pour les nouvelles campagnes."
          },
          "presentCategories": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 60
            },
            "maxItems": 20
          },
          "ambsCategories": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 60
            },
            "maxItems": 20
          },
          "config": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "hidden": {
                      "type": "boolean"
                    },
                    "editable": {
                      "type": "boolean"
                    },
                    "contentType": {
                      "type": "string",
                      "enum": [
                        "EDITOR",
                        "AI"
                      ]
                    },
                    "aiContentBlockId": {
                      "type": "string",
                      "maxLength": 36,
                      "format": "uuid"
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "image": {
                      "type": "string",
                      "maxLength": 255,
                      "format": "asset"
                    },
                    "background": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "color": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "url": {
                      "type": "string",
                      "maxLength": 2000,
                      "format": "safe-url"
                    }
                  },
                  "required": [
                    "id",
                    "type"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "banners": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "maxLength": 36,
                      "format": "uuid"
                    },
                    "image": {
                      "type": "string",
                      "maxLength": 255,
                      "format": "asset"
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "DESKTOP",
                        "MOBILE"
                      ]
                    }
                  },
                  "required": [
                    "image",
                    "type"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 30
              },
              "metaImage": {
                "type": "string",
                "maxLength": 255,
                "format": "asset"
              },
              "banners.youtube": {
                "type": "string",
                "maxLength": 2000,
                "format": "safe-url"
              },
              "template": {
                "type": "string",
                "maxLength": 300
              },
              "designVariant": {
                "type": "string",
                "maxLength": 300,
                "description": "Mise en page de présentation V2. En cas de valeur absente, vide ou non prise en charge, le design standard actuel est utilisé. Indépendante des couleurs et du paiement ; conservée pour la compatibilité future."
              },
              "ambiance": {
                "type": "string",
                "maxLength": 300
              },
              "ald.logo": {
                "type": "string",
                "maxLength": 255,
                "format": "asset"
              },
              "ald.name": {
                "type": "string",
                "maxLength": 300
              },
              "ald.leftBanner": {
                "type": "string",
                "maxLength": 255,
                "format": "asset"
              },
              "ald.presetButtons": {
                "type": "string",
                "maxLength": 2000
              },
              "tokens": {
                "type": "object",
                "properties": {
                  "main": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string",
                      "maxLength": 500
                    },
                    "maxProperties": 100
                  },
                  "custom": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string",
                      "maxLength": 500
                    },
                    "maxProperties": 100
                  }
                },
                "required": [],
                "additionalProperties": false
              },
              "v2Checkout": {
                "type": "boolean"
              },
              "noModal": {
                "type": "boolean"
              },
              "noPromesse": {
                "type": "boolean"
              },
              "hideBar": {
                "type": "boolean"
              },
              "hideOrg": {
                "type": "boolean"
              },
              "autoDisplay": {
                "type": "boolean"
              },
              "forceCelebration": {
                "type": "boolean"
              },
              "fixedMontant": {
                "type": "boolean"
              },
              "noDefaultProduct": {
                "type": "boolean"
              },
              "giftAidBoost": {
                "type": "boolean"
              },
              "minMontant": {
                "type": "number",
                "minimum": 0.01,
                "maximum": 10000000,
                "multipleOf": 0.01
              },
              "productMonth": {
                "type": "boolean"
              },
              "maxNbMonth": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "minNbMonth": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "defaultNbMonth": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "forceMonthNb": {
                "type": "integer",
                "minimum": 0,
                "maximum": 120,
                "nullable": true
              },
              "maxDivideNB": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "monthlyAmountDisplay": {
                "type": "boolean"
              },
              "forceDivideGTEAmount": {
                "type": "number",
                "minimum": 0.01,
                "maximum": 10000000,
                "multipleOf": 0.01
              },
              "forceDivideNB": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "matched": {
                "type": "number",
                "minimum": 1,
                "maximum": 100
              },
              "currencies": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "devise": {
                      "type": "string",
                      "maxLength": 3,
                      "pattern": "^[a-z]{3}$"
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "REAL",
                        "VIRTUAL"
                      ]
                    },
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "assocId": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [
                    "devise",
                    "type"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 20
              },
              "categories": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 60
                },
                "maxItems": 20
              },
              "donorEmailTemplate": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              },
              "fr": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "en": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "he": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "de": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "it": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "es": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "pt": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "ru": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "gr": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "ro": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "fr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          }
        },
        "required": [
          "label",
          "url",
          "objectif"
        ],
        "additionalProperties": false
      },
      "FundraisingConfig": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "maxLength": 300
          },
          "description": {
            "type": "string",
            "maxLength": 50000
          },
          "donationButtonText": {
            "type": "string",
            "maxLength": 300
          },
          "donorName": {
            "type": "string",
            "maxLength": 300
          },
          "donorNameMulti": {
            "type": "string",
            "maxLength": 300
          },
          "sections": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 100
                },
                "type": {
                  "type": "string",
                  "maxLength": 100
                },
                "label": {
                  "type": "string",
                  "maxLength": 300
                },
                "hidden": {
                  "type": "boolean"
                },
                "editable": {
                  "type": "boolean"
                },
                "contentType": {
                  "type": "string",
                  "enum": [
                    "EDITOR",
                    "AI"
                  ]
                },
                "aiContentBlockId": {
                  "type": "string",
                  "maxLength": 36,
                  "format": "uuid"
                },
                "content": {
                  "type": "string",
                  "maxLength": 50000
                },
                "html": {
                  "type": "string",
                  "maxLength": 50000
                },
                "title": {
                  "type": "string",
                  "maxLength": 300
                },
                "description": {
                  "type": "string",
                  "maxLength": 50000
                },
                "image": {
                  "type": "string",
                  "maxLength": 255,
                  "format": "asset"
                },
                "background": {
                  "type": "string",
                  "maxLength": 100
                },
                "color": {
                  "type": "string",
                  "maxLength": 100
                },
                "url": {
                  "type": "string",
                  "maxLength": 2000,
                  "format": "safe-url"
                }
              },
              "required": [
                "id",
                "type"
              ],
              "additionalProperties": false
            },
            "maxItems": 50
          },
          "banners": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 36,
                  "format": "uuid"
                },
                "image": {
                  "type": "string",
                  "maxLength": 255,
                  "format": "asset"
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "DESKTOP",
                    "MOBILE"
                  ]
                }
              },
              "required": [
                "image",
                "type"
              ],
              "additionalProperties": false
            },
            "maxItems": 30
          },
          "metaImage": {
            "type": "string",
            "maxLength": 255,
            "format": "asset"
          },
          "banners.youtube": {
            "type": "string",
            "maxLength": 2000,
            "format": "safe-url"
          },
          "template": {
            "type": "string",
            "maxLength": 300
          },
          "designVariant": {
            "type": "string",
            "maxLength": 300,
            "description": "Mise en page de présentation V2. En cas de valeur absente, vide ou non prise en charge, le design standard actuel est utilisé. Indépendante des couleurs et du paiement ; conservée pour la compatibilité future."
          },
          "ambiance": {
            "type": "string",
            "maxLength": 300
          },
          "ald.logo": {
            "type": "string",
            "maxLength": 255,
            "format": "asset"
          },
          "ald.name": {
            "type": "string",
            "maxLength": 300
          },
          "ald.leftBanner": {
            "type": "string",
            "maxLength": 255,
            "format": "asset"
          },
          "ald.presetButtons": {
            "type": "string",
            "maxLength": 2000
          },
          "tokens": {
            "type": "object",
            "properties": {
              "main": {
                "type": "object",
                "additionalProperties": {
                  "type": "string",
                  "maxLength": 500
                },
                "maxProperties": 100
              },
              "custom": {
                "type": "object",
                "additionalProperties": {
                  "type": "string",
                  "maxLength": 500
                },
                "maxProperties": 100
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "v2Checkout": {
            "type": "boolean"
          },
          "noModal": {
            "type": "boolean"
          },
          "noPromesse": {
            "type": "boolean"
          },
          "hideBar": {
            "type": "boolean"
          },
          "hideOrg": {
            "type": "boolean"
          },
          "autoDisplay": {
            "type": "boolean"
          },
          "forceCelebration": {
            "type": "boolean"
          },
          "fixedMontant": {
            "type": "boolean"
          },
          "noDefaultProduct": {
            "type": "boolean"
          },
          "giftAidBoost": {
            "type": "boolean"
          },
          "minMontant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "productMonth": {
            "type": "boolean"
          },
          "maxNbMonth": {
            "type": "integer",
            "minimum": 1,
            "maximum": 120
          },
          "minNbMonth": {
            "type": "integer",
            "minimum": 1,
            "maximum": 120
          },
          "defaultNbMonth": {
            "type": "integer",
            "minimum": 1,
            "maximum": 120
          },
          "forceMonthNb": {
            "type": "integer",
            "minimum": 0,
            "maximum": 120,
            "nullable": true
          },
          "maxDivideNB": {
            "type": "integer",
            "minimum": 1,
            "maximum": 120
          },
          "monthlyAmountDisplay": {
            "type": "boolean"
          },
          "forceDivideGTEAmount": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "forceDivideNB": {
            "type": "integer",
            "minimum": 1,
            "maximum": 120
          },
          "matched": {
            "type": "number",
            "minimum": 1,
            "maximum": 100
          },
          "currencies": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "devise": {
                  "type": "string",
                  "maxLength": 3,
                  "pattern": "^[a-z]{3}$"
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "REAL",
                    "VIRTUAL"
                  ]
                },
                "label": {
                  "type": "string",
                  "maxLength": 300
                },
                "assocId": {
                  "type": "string",
                  "maxLength": 100
                }
              },
              "required": [
                "devise",
                "type"
              ],
              "additionalProperties": false
            },
            "maxItems": 20
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 60
            },
            "maxItems": 20
          },
          "donorEmailTemplate": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid",
            "nullable": true
          },
          "donorEmailSubject": {
            "type": "string",
            "maxLength": 200
          },
          "fr": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "FundraisingParticipation": {
        "type": "object",
        "properties": {
          "team": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid",
            "nullable": true
          },
          "source": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid",
            "nullable": true
          },
          "displayName": {
            "type": "string",
            "maxLength": 200
          },
          "display": {
            "type": "boolean"
          },
          "comment": {
            "type": "string",
            "maxLength": 3000
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "FundraisingCheckout": {
        "type": "object",
        "properties": {
          "amount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100000000
          },
          "devise": {
            "type": "string",
            "maxLength": 3,
            "pattern": "^[a-z]{3}$"
          },
          "mode": {
            "type": "string",
            "enum": [
              "ONCE",
              "RECURRING",
              "INSTALLMENTS"
            ]
          },
          "installments": {
            "type": "integer",
            "minimum": 1,
            "maximum": 120
          },
          "amountBasis": {
            "type": "string",
            "enum": [
              "MONTHLY",
              "TOTAL"
            ]
          },
          "returnUrl": {
            "type": "string",
            "maxLength": 2000,
            "format": "safe-url"
          },
          "participation": {
            "type": "object",
            "properties": {
              "team": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "source": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "displayName": {
                "type": "string",
                "maxLength": 200
              },
              "display": {
                "type": "boolean"
              },
              "comment": {
                "type": "string",
                "maxLength": 3000
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "reservationId": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          }
        },
        "required": [
          "amount",
          "devise"
        ],
        "additionalProperties": false
      },
      "FundraisingReservation": {
        "type": "object",
        "properties": {
          "products": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 64,
                  "pattern": "^[A-Za-z0-9_-]{1,64}$"
                },
                "nb": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 10000
                }
              },
              "required": [
                "id",
                "nb"
              ],
              "additionalProperties": false
            },
            "maxItems": 50
          }
        },
        "required": [
          "products"
        ],
        "additionalProperties": false
      },
      "FundraisingManualContribution": {
        "type": "object",
        "properties": {
          "montant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "displayName": {
            "type": "string",
            "maxLength": 200
          },
          "comment": {
            "type": "string",
            "maxLength": 3000
          },
          "team": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid",
            "nullable": true
          },
          "source": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid",
            "nullable": true
          },
          "display": {
            "type": "boolean"
          }
        },
        "required": [
          "montant"
        ],
        "additionalProperties": false
      },
      "FundraisingPledge": {
        "type": "object",
        "properties": {
          "contactId": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "montant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "name": {
            "type": "string",
            "maxLength": 300
          },
          "occasion": {
            "type": "string",
            "maxLength": 300
          },
          "participation": {
            "type": "object",
            "properties": {
              "team": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "source": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "displayName": {
                "type": "string",
                "maxLength": 200
              },
              "display": {
                "type": "boolean"
              },
              "comment": {
                "type": "string",
                "maxLength": 3000
              }
            },
            "required": [],
            "additionalProperties": false
          }
        },
        "required": [
          "contactId",
          "montant"
        ],
        "additionalProperties": false
      },
      "FundraisingOfflineDonation": {
        "type": "object",
        "properties": {
          "amount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100000000
          },
          "method": {
            "type": "string",
            "enum": [
              "CB",
              "VIREMENT",
              "CHEQUE",
              "PRELEVEMENT",
              "CASH",
              "NATURE"
            ]
          },
          "contactId": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "datetime": {
            "type": "string",
            "maxLength": 40,
            "format": "date-time",
            "nullable": true
          },
          "externalId": {
            "type": "string",
            "maxLength": 200
          },
          "participation": {
            "type": "object",
            "properties": {
              "team": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "source": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "displayName": {
                "type": "string",
                "maxLength": 200
              },
              "display": {
                "type": "boolean"
              },
              "comment": {
                "type": "string",
                "maxLength": 3000
              }
            },
            "required": [],
            "additionalProperties": false
          }
        },
        "required": [
          "amount",
          "method"
        ],
        "additionalProperties": false
      },
      "FundraisingAction": {
        "type": "object",
        "properties": {},
        "required": [],
        "additionalProperties": false
      },
      "FundraisingPositions": {
        "type": "object",
        "properties": {
          "ids": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 36,
              "format": "uuid"
            },
            "maxItems": 200
          }
        },
        "required": [
          "ids"
        ],
        "additionalProperties": false
      },
      "FundraisingAmbassador": {
        "type": "object",
        "properties": {
          "contactId": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "teamId": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          }
        },
        "required": [
          "contactId",
          "teamId"
        ],
        "additionalProperties": false
      },
      "FundraisingVisit": {
        "type": "object",
        "properties": {
          "visitorId": {
            "type": "string",
            "maxLength": 100
          },
          "team": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "source": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "url": {
            "type": "string",
            "maxLength": 2000,
            "format": "safe-url"
          }
        },
        "required": [
          "visitorId"
        ],
        "additionalProperties": false
      },
      "FundraisingSectionContent": {
        "type": "object",
        "properties": {
          "content": {
            "type": "string",
            "maxLength": 500000
          },
          "editVersion": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          }
        },
        "required": [
          "content",
          "editVersion"
        ],
        "additionalProperties": false
      },
      "Fundraisingteams": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 200
          },
          "param": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-z0-9][a-z0-9_-]*$"
          },
          "objectif": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "description": {
            "type": "string",
            "maxLength": 50000
          },
          "color": {
            "type": "string",
            "maxLength": 9,
            "pattern": "^#[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$"
          },
          "hidden": {
            "type": "boolean"
          },
          "fr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          }
        },
        "required": [
          "label",
          "param"
        ],
        "additionalProperties": false
      },
      "Fundraisingsources": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 200
          },
          "param": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-z0-9][a-z0-9_-]*$"
          },
          "fr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          }
        },
        "required": [
          "label",
          "param"
        ],
        "additionalProperties": false
      },
      "Fundraisingproducts": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 200
          },
          "description": {
            "type": "string",
            "maxLength": 50000
          },
          "montant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "image": {
            "type": "string",
            "maxLength": 255,
            "format": "asset"
          },
          "prices": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 10000000,
              "multipleOf": 0.01
            },
            "maxProperties": 20
          },
          "stock": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000
          },
          "position": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000
          },
          "fr": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          }
        },
        "required": [
          "name",
          "montant"
        ],
        "additionalProperties": false
      },
      "Fundraisingcounters": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 200
          },
          "name": {
            "type": "string",
            "maxLength": 200
          },
          "description": {
            "type": "string",
            "maxLength": 50000
          },
          "nb": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          },
          "position": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000
          },
          "fr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          }
        },
        "required": [
          "label"
        ],
        "additionalProperties": false
      },
      "FundraisingDuplicate": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 120
          },
          "url": {
            "type": "string",
            "maxLength": 60,
            "pattern": "^campaign-[a-z0-9][a-z0-9-]{0,49}[a-z0-9]$"
          },
          "type": {
            "type": "string",
            "enum": [
              "AMOUNT",
              "COUNT",
              "PARTNER"
            ]
          },
          "objectif": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 1000000000,
            "multipleOf": 0.01
          },
          "matched": {
            "type": "number",
            "minimum": 1,
            "maximum": 100
          },
          "partnerMontant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "dateStart": {
            "type": "string",
            "maxLength": 40,
            "format": "date-time",
            "nullable": true
          },
          "dateEnd": {
            "type": "string",
            "maxLength": 40,
            "format": "date-time",
            "nullable": true
          },
          "donationPolicy": {
            "type": "string",
            "enum": [
              "OPEN",
              "SCHEDULED"
            ]
          },
          "bonus": {
            "type": "array",
            "items": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 10000000,
              "multipleOf": 0.01
            },
            "maxItems": 30
          },
          "gala": {
            "type": "boolean"
          },
          "ambs": {
            "type": "boolean"
          },
          "stockable": {
            "type": "boolean"
          },
          "tombola": {
            "type": "boolean",
            "deprecated": true,
            "description": "Alias historique de stockable. Conservé en lecture pour compatibilité ; utilisez stockable pour les nouvelles campagnes."
          },
          "presentCategories": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 60
            },
            "maxItems": 20
          },
          "ambsCategories": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 60
            },
            "maxItems": 20
          },
          "config": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "hidden": {
                      "type": "boolean"
                    },
                    "editable": {
                      "type": "boolean"
                    },
                    "contentType": {
                      "type": "string",
                      "enum": [
                        "EDITOR",
                        "AI"
                      ]
                    },
                    "aiContentBlockId": {
                      "type": "string",
                      "maxLength": 36,
                      "format": "uuid"
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "image": {
                      "type": "string",
                      "maxLength": 255,
                      "format": "asset"
                    },
                    "background": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "color": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "url": {
                      "type": "string",
                      "maxLength": 2000,
                      "format": "safe-url"
                    }
                  },
                  "required": [
                    "id",
                    "type"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "banners": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "maxLength": 36,
                      "format": "uuid"
                    },
                    "image": {
                      "type": "string",
                      "maxLength": 255,
                      "format": "asset"
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "DESKTOP",
                        "MOBILE"
                      ]
                    }
                  },
                  "required": [
                    "image",
                    "type"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 30
              },
              "metaImage": {
                "type": "string",
                "maxLength": 255,
                "format": "asset"
              },
              "banners.youtube": {
                "type": "string",
                "maxLength": 2000,
                "format": "safe-url"
              },
              "template": {
                "type": "string",
                "maxLength": 300
              },
              "designVariant": {
                "type": "string",
                "maxLength": 300,
                "description": "Mise en page de présentation V2. En cas de valeur absente, vide ou non prise en charge, le design standard actuel est utilisé. Indépendante des couleurs et du paiement ; conservée pour la compatibilité future."
              },
              "ambiance": {
                "type": "string",
                "maxLength": 300
              },
              "ald.logo": {
                "type": "string",
                "maxLength": 255,
                "format": "asset"
              },
              "ald.name": {
                "type": "string",
                "maxLength": 300
              },
              "ald.leftBanner": {
                "type": "string",
                "maxLength": 255,
                "format": "asset"
              },
              "ald.presetButtons": {
                "type": "string",
                "maxLength": 2000
              },
              "tokens": {
                "type": "object",
                "properties": {
                  "main": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string",
                      "maxLength": 500
                    },
                    "maxProperties": 100
                  },
                  "custom": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string",
                      "maxLength": 500
                    },
                    "maxProperties": 100
                  }
                },
                "required": [],
                "additionalProperties": false
              },
              "v2Checkout": {
                "type": "boolean"
              },
              "noModal": {
                "type": "boolean"
              },
              "noPromesse": {
                "type": "boolean"
              },
              "hideBar": {
                "type": "boolean"
              },
              "hideOrg": {
                "type": "boolean"
              },
              "autoDisplay": {
                "type": "boolean"
              },
              "forceCelebration": {
                "type": "boolean"
              },
              "fixedMontant": {
                "type": "boolean"
              },
              "noDefaultProduct": {
                "type": "boolean"
              },
              "giftAidBoost": {
                "type": "boolean"
              },
              "minMontant": {
                "type": "number",
                "minimum": 0.01,
                "maximum": 10000000,
                "multipleOf": 0.01
              },
              "productMonth": {
                "type": "boolean"
              },
              "maxNbMonth": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "minNbMonth": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "defaultNbMonth": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "forceMonthNb": {
                "type": "integer",
                "minimum": 0,
                "maximum": 120,
                "nullable": true
              },
              "maxDivideNB": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "monthlyAmountDisplay": {
                "type": "boolean"
              },
              "forceDivideGTEAmount": {
                "type": "number",
                "minimum": 0.01,
                "maximum": 10000000,
                "multipleOf": 0.01
              },
              "forceDivideNB": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "matched": {
                "type": "number",
                "minimum": 1,
                "maximum": 100
              },
              "currencies": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "devise": {
                      "type": "string",
                      "maxLength": 3,
                      "pattern": "^[a-z]{3}$"
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "REAL",
                        "VIRTUAL"
                      ]
                    },
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "assocId": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [
                    "devise",
                    "type"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 20
              },
              "categories": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 60
                },
                "maxItems": 20
              },
              "donorEmailTemplate": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              },
              "fr": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "en": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "he": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "de": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "it": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "es": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "pt": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "ru": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "gr": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "ro": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "fr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          }
        },
        "required": [
          "label",
          "url"
        ],
        "additionalProperties": false
      },
      "FundraisingConfigSection": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "maxLength": 300
          },
          "description": {
            "type": "string",
            "maxLength": 50000
          },
          "donationButtonText": {
            "type": "string",
            "maxLength": 300
          },
          "donorName": {
            "type": "string",
            "maxLength": 300
          },
          "donorNameMulti": {
            "type": "string",
            "maxLength": 300
          },
          "sections": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 100
                },
                "type": {
                  "type": "string",
                  "maxLength": 100
                },
                "label": {
                  "type": "string",
                  "maxLength": 300
                },
                "hidden": {
                  "type": "boolean"
                },
                "editable": {
                  "type": "boolean"
                },
                "contentType": {
                  "type": "string",
                  "enum": [
                    "EDITOR",
                    "AI"
                  ]
                },
                "aiContentBlockId": {
                  "type": "string",
                  "maxLength": 36,
                  "format": "uuid"
                },
                "content": {
                  "type": "string",
                  "maxLength": 50000
                },
                "html": {
                  "type": "string",
                  "maxLength": 50000
                },
                "title": {
                  "type": "string",
                  "maxLength": 300
                },
                "description": {
                  "type": "string",
                  "maxLength": 50000
                },
                "image": {
                  "type": "string",
                  "maxLength": 255,
                  "format": "asset"
                },
                "background": {
                  "type": "string",
                  "maxLength": 100
                },
                "color": {
                  "type": "string",
                  "maxLength": 100
                },
                "url": {
                  "type": "string",
                  "maxLength": 2000,
                  "format": "safe-url"
                }
              },
              "required": [
                "id",
                "type"
              ],
              "additionalProperties": false
            },
            "maxItems": 50
          },
          "banners": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 36,
                  "format": "uuid"
                },
                "image": {
                  "type": "string",
                  "maxLength": 255,
                  "format": "asset"
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "DESKTOP",
                    "MOBILE"
                  ]
                }
              },
              "required": [
                "image",
                "type"
              ],
              "additionalProperties": false
            },
            "maxItems": 30
          },
          "metaImage": {
            "type": "string",
            "maxLength": 255,
            "format": "asset"
          },
          "banners.youtube": {
            "type": "string",
            "maxLength": 2000,
            "format": "safe-url"
          },
          "template": {
            "type": "string",
            "maxLength": 300
          },
          "designVariant": {
            "type": "string",
            "maxLength": 300,
            "description": "Mise en page de présentation V2. En cas de valeur absente, vide ou non prise en charge, le design standard actuel est utilisé. Indépendante des couleurs et du paiement ; conservée pour la compatibilité future."
          },
          "ambiance": {
            "type": "string",
            "maxLength": 300
          },
          "ald.logo": {
            "type": "string",
            "maxLength": 255,
            "format": "asset"
          },
          "ald.name": {
            "type": "string",
            "maxLength": 300
          },
          "ald.leftBanner": {
            "type": "string",
            "maxLength": 255,
            "format": "asset"
          },
          "ald.presetButtons": {
            "type": "string",
            "maxLength": 2000
          },
          "tokens": {
            "type": "object",
            "properties": {
              "main": {
                "type": "object",
                "additionalProperties": {
                  "type": "string",
                  "maxLength": 500
                },
                "maxProperties": 100
              },
              "custom": {
                "type": "object",
                "additionalProperties": {
                  "type": "string",
                  "maxLength": 500
                },
                "maxProperties": 100
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "v2Checkout": {
            "type": "boolean"
          },
          "noModal": {
            "type": "boolean"
          },
          "noPromesse": {
            "type": "boolean"
          },
          "hideBar": {
            "type": "boolean"
          },
          "hideOrg": {
            "type": "boolean"
          },
          "autoDisplay": {
            "type": "boolean"
          },
          "forceCelebration": {
            "type": "boolean"
          },
          "fixedMontant": {
            "type": "boolean"
          },
          "noDefaultProduct": {
            "type": "boolean"
          },
          "giftAidBoost": {
            "type": "boolean"
          },
          "minMontant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "productMonth": {
            "type": "boolean"
          },
          "maxNbMonth": {
            "type": "integer",
            "minimum": 1,
            "maximum": 120
          },
          "minNbMonth": {
            "type": "integer",
            "minimum": 1,
            "maximum": 120
          },
          "defaultNbMonth": {
            "type": "integer",
            "minimum": 1,
            "maximum": 120
          },
          "forceMonthNb": {
            "type": "integer",
            "minimum": 0,
            "maximum": 120,
            "nullable": true
          },
          "maxDivideNB": {
            "type": "integer",
            "minimum": 1,
            "maximum": 120
          },
          "monthlyAmountDisplay": {
            "type": "boolean"
          },
          "forceDivideGTEAmount": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "forceDivideNB": {
            "type": "integer",
            "minimum": 1,
            "maximum": 120
          },
          "matched": {
            "type": "number",
            "minimum": 1,
            "maximum": 100
          },
          "currencies": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "devise": {
                  "type": "string",
                  "maxLength": 3,
                  "pattern": "^[a-z]{3}$"
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "REAL",
                    "VIRTUAL"
                  ]
                },
                "label": {
                  "type": "string",
                  "maxLength": 300
                },
                "assocId": {
                  "type": "string",
                  "maxLength": 100
                }
              },
              "required": [
                "devise",
                "type"
              ],
              "additionalProperties": false
            },
            "maxItems": 20
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 60
            },
            "maxItems": 20
          },
          "donorEmailTemplate": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid",
            "nullable": true
          },
          "donorEmailSubject": {
            "type": "string",
            "maxLength": 200
          },
          "fr": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          }
        },
        "required": [],
        "additionalProperties": false,
        "description": "Champs partiels de la section sélectionnée : contenu, apparence, dons, devises ou automatisation. Seuls les champs de cette section sont enregistrés."
      },
      "FundraisingCampaignRead": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 120
          },
          "url": {
            "type": "string",
            "maxLength": 60,
            "pattern": "^campaign-[a-z0-9][a-z0-9-]{0,49}[a-z0-9]$"
          },
          "type": {
            "type": "string",
            "enum": [
              "AMOUNT",
              "COUNT",
              "PARTNER"
            ]
          },
          "objectif": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 1000000000,
            "multipleOf": 0.01
          },
          "matched": {
            "type": "number",
            "minimum": 1,
            "maximum": 100
          },
          "partnerMontant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "dateStart": {
            "type": "string",
            "maxLength": 40,
            "format": "date-time",
            "nullable": true
          },
          "dateEnd": {
            "type": "string",
            "maxLength": 40,
            "format": "date-time",
            "nullable": true
          },
          "donationPolicy": {
            "type": "string",
            "enum": [
              "OPEN",
              "SCHEDULED"
            ]
          },
          "bonus": {
            "type": "array",
            "items": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 10000000,
              "multipleOf": 0.01
            },
            "maxItems": 30
          },
          "gala": {
            "type": "boolean"
          },
          "ambs": {
            "type": "boolean"
          },
          "stockable": {
            "type": "boolean"
          },
          "tombola": {
            "type": "boolean",
            "deprecated": true,
            "description": "Alias historique de stockable. Conservé en lecture pour compatibilité ; utilisez stockable pour les nouvelles campagnes."
          },
          "presentCategories": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 60
            },
            "maxItems": 20
          },
          "ambsCategories": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 60
            },
            "maxItems": 20
          },
          "config": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "maxLength": 300
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              },
              "donationButtonText": {
                "type": "string",
                "maxLength": 300
              },
              "donorName": {
                "type": "string",
                "maxLength": 300
              },
              "donorNameMulti": {
                "type": "string",
                "maxLength": 300
              },
              "sections": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "type": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "hidden": {
                      "type": "boolean"
                    },
                    "editable": {
                      "type": "boolean"
                    },
                    "contentType": {
                      "type": "string",
                      "enum": [
                        "EDITOR",
                        "AI"
                      ]
                    },
                    "aiContentBlockId": {
                      "type": "string",
                      "maxLength": 36,
                      "format": "uuid"
                    },
                    "content": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "html": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "title": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": {
                      "type": "string",
                      "maxLength": 50000
                    },
                    "image": {
                      "type": "string",
                      "maxLength": 255,
                      "format": "asset"
                    },
                    "background": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "color": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "url": {
                      "type": "string",
                      "maxLength": 2000,
                      "format": "safe-url"
                    }
                  },
                  "required": [
                    "id",
                    "type"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 50
              },
              "banners": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "maxLength": 36,
                      "format": "uuid"
                    },
                    "image": {
                      "type": "string",
                      "maxLength": 255,
                      "format": "asset"
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "DESKTOP",
                        "MOBILE"
                      ]
                    }
                  },
                  "required": [
                    "image",
                    "type"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 30
              },
              "metaImage": {
                "type": "string",
                "maxLength": 255,
                "format": "asset"
              },
              "banners.youtube": {
                "type": "string",
                "maxLength": 2000,
                "format": "safe-url"
              },
              "template": {
                "type": "string",
                "maxLength": 300
              },
              "designVariant": {
                "type": "string",
                "maxLength": 300,
                "description": "Mise en page de présentation V2. En cas de valeur absente, vide ou non prise en charge, le design standard actuel est utilisé. Indépendante des couleurs et du paiement ; conservée pour la compatibilité future."
              },
              "ambiance": {
                "type": "string",
                "maxLength": 300
              },
              "ald.logo": {
                "type": "string",
                "maxLength": 255,
                "format": "asset"
              },
              "ald.name": {
                "type": "string",
                "maxLength": 300
              },
              "ald.leftBanner": {
                "type": "string",
                "maxLength": 255,
                "format": "asset"
              },
              "ald.presetButtons": {
                "type": "string",
                "maxLength": 2000
              },
              "tokens": {
                "type": "object",
                "properties": {
                  "main": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string",
                      "maxLength": 500
                    },
                    "maxProperties": 100
                  },
                  "custom": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string",
                      "maxLength": 500
                    },
                    "maxProperties": 100
                  }
                },
                "required": [],
                "additionalProperties": false
              },
              "v2Checkout": {
                "type": "boolean"
              },
              "noModal": {
                "type": "boolean"
              },
              "noPromesse": {
                "type": "boolean"
              },
              "hideBar": {
                "type": "boolean"
              },
              "hideOrg": {
                "type": "boolean"
              },
              "autoDisplay": {
                "type": "boolean"
              },
              "forceCelebration": {
                "type": "boolean"
              },
              "fixedMontant": {
                "type": "boolean"
              },
              "noDefaultProduct": {
                "type": "boolean"
              },
              "giftAidBoost": {
                "type": "boolean"
              },
              "minMontant": {
                "type": "number",
                "minimum": 0.01,
                "maximum": 10000000,
                "multipleOf": 0.01
              },
              "productMonth": {
                "type": "boolean"
              },
              "maxNbMonth": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "minNbMonth": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "defaultNbMonth": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "forceMonthNb": {
                "type": "integer",
                "minimum": 0,
                "maximum": 120,
                "nullable": true
              },
              "maxDivideNB": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "monthlyAmountDisplay": {
                "type": "boolean"
              },
              "forceDivideGTEAmount": {
                "type": "number",
                "minimum": 0.01,
                "maximum": 10000000,
                "multipleOf": 0.01
              },
              "forceDivideNB": {
                "type": "integer",
                "minimum": 1,
                "maximum": 120
              },
              "matched": {
                "type": "number",
                "minimum": 1,
                "maximum": 100
              },
              "currencies": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "devise": {
                      "type": "string",
                      "maxLength": 3,
                      "pattern": "^[a-z]{3}$"
                    },
                    "type": {
                      "type": "string",
                      "enum": [
                        "REAL",
                        "VIRTUAL"
                      ]
                    },
                    "label": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "assocId": {
                      "type": "string",
                      "maxLength": 100
                    }
                  },
                  "required": [
                    "devise",
                    "type"
                  ],
                  "additionalProperties": false
                },
                "maxItems": 20
              },
              "categories": {
                "type": "array",
                "items": {
                  "type": "string",
                  "maxLength": 60
                },
                "maxItems": 20
              },
              "donorEmailTemplate": {
                "type": "string",
                "maxLength": 36,
                "format": "uuid",
                "nullable": true
              },
              "donorEmailSubject": {
                "type": "string",
                "maxLength": 200
              },
              "fr": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "en": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "he": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "de": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "it": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "es": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "pt": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "ru": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "gr": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              },
              "ro": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "description": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "donationButtonText": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "donorNameMulti": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "sections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "content": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "html": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "title": {
                          "type": "string",
                          "maxLength": 300
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "id": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        }
                      },
                      "required": [],
                      "additionalProperties": false
                    },
                    "maxItems": 50
                  },
                  "donorEmailSubject": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [],
                "additionalProperties": false,
                "nullable": true,
                "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "id": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid",
            "readOnly": true
          },
          "status": {
            "type": "string",
            "enum": [
              "DRAFT",
              "PUBLISHED",
              "PAUSED",
              "ARCHIVED"
            ],
            "readOnly": true
          },
          "revision": {
            "type": "integer",
            "readOnly": true
          },
          "acceptingDonations": {
            "type": "boolean",
            "readOnly": true
          },
          "fr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 120
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "FundraisingteamsRead": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 200
          },
          "param": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-z0-9][a-z0-9_-]*$"
          },
          "objectif": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "description": {
            "type": "string",
            "maxLength": 50000
          },
          "color": {
            "type": "string",
            "maxLength": 9,
            "pattern": "^#[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$"
          },
          "hidden": {
            "type": "boolean"
          },
          "fr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "id": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "revision": {
            "type": "integer"
          },
          "datetime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "FundraisingsourcesRead": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 200
          },
          "param": {
            "type": "string",
            "maxLength": 100,
            "pattern": "^[a-z0-9][a-z0-9_-]*$"
          },
          "fr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "id": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "revision": {
            "type": "integer"
          },
          "datetime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "FundraisingproductsRead": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 200
          },
          "description": {
            "type": "string",
            "maxLength": 50000
          },
          "montant": {
            "type": "number",
            "minimum": 0.01,
            "maximum": 10000000,
            "multipleOf": 0.01
          },
          "image": {
            "type": "string",
            "maxLength": 255,
            "format": "asset"
          },
          "prices": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 10000000,
              "multipleOf": 0.01
            },
            "maxProperties": 20
          },
          "stock": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000
          },
          "position": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000
          },
          "fr": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "id": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "revision": {
            "type": "integer"
          },
          "datetime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "FundraisingcountersRead": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 200
          },
          "name": {
            "type": "string",
            "maxLength": 200
          },
          "description": {
            "type": "string",
            "maxLength": 50000
          },
          "nb": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          },
          "position": {
            "type": "integer",
            "minimum": 0,
            "maximum": 10000
          },
          "fr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "en": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "he": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "de": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "it": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "es": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "pt": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ru": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "gr": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "ro": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string",
                "maxLength": 200
              },
              "name": {
                "type": "string",
                "maxLength": 200
              },
              "description": {
                "type": "string",
                "maxLength": 50000
              }
            },
            "required": [],
            "additionalProperties": false,
            "nullable": true,
            "description": "Surcharge pour une langue secondaire activée. La langue par défaut utilise les champs racine ; null supprime une surcharge."
          },
          "id": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "revision": {
            "type": "integer"
          },
          "datetime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "FundraisingCheckoutRead": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "state": {
            "type": "string",
            "enum": [
              "OPEN",
              "EXPIRED",
              "CANCELED",
              "SUBMITTED",
              "PROCESSING",
              "COMPLETED",
              "REFUND_PENDING",
              "REFUNDED",
              "RECONCILIATION_REQUIRED"
            ]
          },
          "amount": {
            "type": "integer"
          },
          "installmentAmount": {
            "type": "integer"
          },
          "devise": {
            "type": "string",
            "maxLength": 3
          },
          "mode": {
            "type": "string",
            "enum": [
              "ONCE",
              "RECURRING",
              "INSTALLMENTS"
            ]
          },
          "installments": {
            "type": "integer",
            "nullable": true
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          },
          "url": {
            "type": "string",
            "maxLength": 2000
          },
          "paymentId": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid",
            "nullable": true
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "FundraisingProgress": {
        "type": "object",
        "properties": {
          "devise": {
            "type": "string",
            "maxLength": 3
          },
          "objectif": {
            "type": "number"
          },
          "type": {
            "type": "string",
            "enum": [
              "AMOUNT",
              "COUNT",
              "PARTNER"
            ]
          },
          "acceptingDonations": {
            "type": "boolean"
          },
          "totals": {
            "type": "object",
            "additionalProperties": true
          },
          "visitors": {
            "type": "integer"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "FundraisingDonor": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "type": {
            "type": "string",
            "maxLength": 30
          },
          "amount": {
            "type": "integer"
          },
          "devise": {
            "type": "string",
            "maxLength": 3
          },
          "displayName": {
            "type": "string",
            "maxLength": 200
          },
          "comment": {
            "type": "string",
            "maxLength": 3000
          },
          "team": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid",
            "nullable": true
          },
          "datetime": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "FundraisingSectionContentRead": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 36,
            "format": "uuid"
          },
          "content": {
            "type": "string",
            "maxLength": 500000,
            "nullable": true
          },
          "editVersion": {
            "type": "integer"
          },
          "success": {
            "type": "boolean"
          },
          "status": {
            "type": "integer"
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "EmailTemplateCatalogMetadata": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "DRAFT",
              "PUBLISHED"
            ],
            "readOnly": true
          },
          "language": {
            "type": "string",
            "pattern": "^[a-z]{2,3}(-[a-z]{2})?$",
            "example": "fr",
            "description": "Langue du modèle. Créez un modèle par langue."
          },
          "category": {
            "type": "string",
            "maxLength": 80,
            "example": "Remerciements"
          },
          "subject": {
            "type": "string",
            "maxLength": 180,
            "description": "Objet d’email suggéré ; les variables de l’organisation sont prises en charge."
          },
          "preheader": {
            "type": "string",
            "maxLength": 240,
            "description": "Texte d’aperçu facultatif de la boîte de réception ; les variables de l’organisation sont prises en charge."
          },
          "description": {
            "type": "string",
            "maxLength": 600,
            "description": "Explication destinée au client sur les cas d’utilisation de ce modèle."
          },
          "familyKey": {
            "type": "string",
            "maxLength": 100,
            "description": "Clé stable partagée par les traductions d’un même modèle, par ex. donation-thanks."
          },
          "tags": {
            "type": "array",
            "maxItems": 20,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "maxLength": 60
            }
          },
          "version": {
            "type": "integer",
            "minimum": 0,
            "readOnly": true
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "publishedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          }
        }
      },
      "EmailTemplateCatalogItem": {
        "type": "object",
        "description": "Source globale stockée dans la collection dédiée email_template_catalog. Elle ne devient pas un modèle d’email propre à une organisation tant qu’elle n’est pas importée.",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "name": {
            "type": "string"
          },
          "editorType": {
            "type": "string",
            "enum": [
              "AI"
            ],
            "readOnly": true
          },
          "html": {
            "type": "string",
            "nullable": true
          },
          "thumbnailUrl": {
            "type": "string",
            "format": "uri",
            "nullable": true,
            "readOnly": true
          },
          "catalog": {
            "$ref": "#/components/schemas/EmailTemplateCatalogMetadata"
          },
          "datetime": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "editDatetime": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          },
          "alreadyImported": {
            "type": "boolean",
            "readOnly": true
          }
        }
      },
      "EmailTemplateCatalogCreateInput": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "name",
          "html",
          "language",
          "category",
          "subject"
        ],
        "description": "Créer un brouillon complet du catalogue en un seul appel.\n\nRègles de compatibilité des clients de messagerie :\n- Envoyez un document HTML UTF-8 COMPLET avec `<!doctype html>`, `<html>`, `<head>` et `<body>`.\n- Construisez la mise en page avec des tableaux de présentation (`<table role=\"presentation\">`, `<tr>`, `<td>`), jamais avec flexbox ou CSS grid.\n- Limitez l’email principal à 600px de largeur et centrez-le sur un arrière-plan pleine largeur neutre.\n- Placez les styles essentiels en ligne. Ne dépendez pas des classes CSS, polices web, feuilles de style externes, images d’arrière-plan ou effets de survol ; Outlook et certains webmails les suppriment.\n- Attribuez à chaque `<img>` des attributs HTML `width` et `height` numériques explicites, un texte `alt` pertinent et une source HTTPS sûre ou `{{org.logoUrl}}`.\n- Utilisez uniquement Arial, Helvetica et sans-serif pour le texte essentiel.\n- Incluez un pré-en-tête masqué, un en-tête de marque, un corps lisible et un pied de page légal contenant `{{mailing_unsubscribe}}`.\n- N’incluez jamais de scripts, gestionnaires d’événements, iframes, formulaires, objets, embeds ou URL `javascript:`.\n- Un brouillon peut toujours être prévisualisé. Avant publication, appelez la validation et corrigez chaque erreur et avertissement de compatibilité pour un résultat plus fiable sur Gmail/Apple Mail/Outlook.\n\nRègles relatives aux variables :\n- Utilisez uniquement les variables renvoyées par `list_email_template_variables`.\n- Les variables d’organisation utilisent une marque d’exemple sans risque dans l’aperçu de rédaction, puis sont résolues selon l’organisation cliente authentifiée lors de l’aperçu/de l’importation client.\n- Les variables du destinataire `{{firstname}}`, `{{lastname}}`, `{{hebrewname}}` et `{{mailing_unsubscribe}}` doivent rester dans le HTML stocké ; elles sont résolues uniquement à l’envoi de l’email. Les alias historiques `{{prenom}}`, `{{nom}}` et `{{prenomHE}}` restent pris en charge ; privilégiez les jetons canoniques dans les nouveaux modèles.\n- `{{mailing_unsubscribe}}` est obligatoire dans le pied de page.\n- Ne collez jamais le nom, l’URL du logo, l’adresse, le téléphone ou le site web réels d’un client dans un modèle central.",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 160,
            "description": "Nom interne du catalogue."
          },
          "html": {
            "type": "string",
            "maxLength": 2000000,
            "description": "Email HTML complet. Respectez toutes les règles de compatibilité des clients de messagerie et d’utilisation des variables ci-dessus."
          },
          "language": {
            "type": "string",
            "pattern": "^[a-z]{2,3}(-[a-z]{2})?$",
            "example": "fr",
            "description": "Langue du modèle. Créez un modèle par langue."
          },
          "category": {
            "type": "string",
            "maxLength": 80,
            "example": "Remerciements"
          },
          "subject": {
            "type": "string",
            "maxLength": 180,
            "description": "Objet d’email suggéré ; les variables de l’organisation sont prises en charge."
          },
          "preheader": {
            "type": "string",
            "maxLength": 240,
            "description": "Texte d’aperçu facultatif de la boîte de réception ; les variables de l’organisation sont prises en charge."
          },
          "description": {
            "type": "string",
            "maxLength": 600,
            "description": "Explication destinée au client sur les cas d’utilisation de ce modèle."
          },
          "familyKey": {
            "type": "string",
            "maxLength": 100,
            "description": "Clé stable partagée par les traductions d’un même modèle, par ex. donation-thanks."
          },
          "tags": {
            "type": "array",
            "maxItems": 20,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "maxLength": 60
            }
          }
        }
      },
      "EmailTemplateCatalogUpdateInput": {
        "type": "object",
        "additionalProperties": false,
        "minProperties": 1,
        "description": "Mettre à jour les métadonnées du catalogue. Toute mise à jour fait repasser un modèle publié à l’état DRAFT ; publiez-le à nouveau après validation.",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 160
          },
          "language": {
            "type": "string",
            "pattern": "^[a-z]{2,3}(-[a-z]{2})?$",
            "example": "fr",
            "description": "Langue du modèle. Créez un modèle par langue."
          },
          "category": {
            "type": "string",
            "maxLength": 80,
            "example": "Remerciements"
          },
          "subject": {
            "type": "string",
            "maxLength": 180,
            "description": "Objet d’email suggéré ; les variables de l’organisation sont prises en charge."
          },
          "preheader": {
            "type": "string",
            "maxLength": 240,
            "description": "Texte d’aperçu facultatif de la boîte de réception ; les variables de l’organisation sont prises en charge."
          },
          "description": {
            "type": "string",
            "maxLength": 600,
            "description": "Explication destinée au client sur les cas d’utilisation de ce modèle."
          },
          "familyKey": {
            "type": "string",
            "maxLength": 100,
            "description": "Clé stable partagée par les traductions d’un même modèle, par ex. donation-thanks."
          },
          "tags": {
            "type": "array",
            "maxItems": 20,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "maxLength": 60
            }
          }
        }
      },
      "EmailTemplateVariableDefinition": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "example": "org.logoUrl"
          },
          "token": {
            "type": "string",
            "example": "{{org.logoUrl}}"
          },
          "description": {
            "type": "string"
          },
          "resolvedAt": {
            "type": "string",
            "enum": [
              "preview_and_import",
              "send"
            ]
          },
          "example": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "EmailTemplateVariableCatalogue": {
        "type": "object",
        "properties": {
          "organisation": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EmailTemplateVariableDefinition"
            }
          },
          "recipient": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EmailTemplateVariableDefinition"
            }
          }
        }
      },
      "EmailTemplateValidationIssue": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "variables": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "EmailTemplateValidation": {
        "type": "object",
        "properties": {
          "valid": {
            "type": "boolean"
          },
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EmailTemplateValidationIssue"
            }
          },
          "warnings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EmailTemplateValidationIssue"
            }
          },
          "variables": {
            "type": "object",
            "properties": {
              "used": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "organisation": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "recipient": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "unknown": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "EmailTemplateCatalogContentInput": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "html"
        ],
        "description": "Remplacer l’intégralité du HTML et faire repasser le modèle à l’état DRAFT.\n\nRègles de compatibilité des clients de messagerie :\n- Envoyez un document HTML UTF-8 COMPLET avec `<!doctype html>`, `<html>`, `<head>` et `<body>`.\n- Construisez la mise en page avec des tableaux de présentation (`<table role=\"presentation\">`, `<tr>`, `<td>`), jamais avec flexbox ou CSS grid.\n- Limitez l’email principal à 600px de largeur et centrez-le sur un arrière-plan pleine largeur neutre.\n- Placez les styles essentiels en ligne. Ne dépendez pas des classes CSS, polices web, feuilles de style externes, images d’arrière-plan ou effets de survol ; Outlook et certains webmails les suppriment.\n- Attribuez à chaque `<img>` des attributs HTML `width` et `height` numériques explicites, un texte `alt` pertinent et une source HTTPS sûre ou `{{org.logoUrl}}`.\n- Utilisez uniquement Arial, Helvetica et sans-serif pour le texte essentiel.\n- Incluez un pré-en-tête masqué, un en-tête de marque, un corps lisible et un pied de page légal contenant `{{mailing_unsubscribe}}`.\n- N’incluez jamais de scripts, gestionnaires d’événements, iframes, formulaires, objets, embeds ou URL `javascript:`.\n- Un brouillon peut toujours être prévisualisé. Avant publication, appelez la validation et corrigez chaque erreur et avertissement de compatibilité pour un résultat plus fiable sur Gmail/Apple Mail/Outlook.\n\nRègles relatives aux variables :\n- Utilisez uniquement les variables renvoyées par `list_email_template_variables`.\n- Les variables d’organisation utilisent une marque d’exemple sans risque dans l’aperçu de rédaction, puis sont résolues selon l’organisation cliente authentifiée lors de l’aperçu/de l’importation client.\n- Les variables du destinataire `{{firstname}}`, `{{lastname}}`, `{{hebrewname}}` et `{{mailing_unsubscribe}}` doivent rester dans le HTML stocké ; elles sont résolues uniquement à l’envoi de l’email. Les alias historiques `{{prenom}}`, `{{nom}}` et `{{prenomHE}}` restent pris en charge ; privilégiez les jetons canoniques dans les nouveaux modèles.\n- `{{mailing_unsubscribe}}` est obligatoire dans le pied de page.\n- Ne collez jamais le nom, l’URL du logo, l’adresse, le téléphone ou le site web réels d’un client dans un modèle central.",
        "properties": {
          "html": {
            "type": "string",
            "maxLength": 2000000
          }
        }
      },
      "EmailTemplateCatalogAssetInput": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "data"
        ],
        "description": "Téléverser une image d’email depuis une chaîne base64 brute ou une URL data. Utilisez l’URL HTTPS renvoyée dans le HTML du catalogue. Taille décodée maximale : 5 MB.",
        "properties": {
          "data": {
            "type": "string",
            "format": "byte",
            "description": "Données d’image en base64 brut, ou URL complète data:image/...;base64,... ."
          },
          "mimeType": {
            "type": "string",
            "enum": [
              "image/png",
              "image/jpeg",
              "image/jpg",
              "image/webp"
            ]
          },
          "name": {
            "type": "string",
            "maxLength": 160
          }
        }
      },
      "EmailTemplateCatalogAsset": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "filename": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "mimeType": {
            "type": "string"
          },
          "size": {
            "type": "integer"
          },
          "width": {
            "type": "integer"
          },
          "height": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "EmailTemplatePreviewLinkInput": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "expiresInSeconds": {
            "type": "integer",
            "minimum": 60,
            "maximum": 3600,
            "default": 900
          }
        }
      },
      "EmailTemplatePreviewLink": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "URL signée de courte durée, ouvrable directement dans un navigateur sans en-têtes API."
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          },
          "previewContext": {
            "type": "string",
            "enum": [
              "SAMPLE",
              "ORGANISATION"
            ]
          },
          "targetOrganisationId": {
            "type": "string",
            "nullable": true
          },
          "subject": {
            "type": "string",
            "description": "Objet affiché avec l’organisation cible dans l’aperçu d’une bibliothèque cliente."
          },
          "preheader": {
            "type": "string",
            "description": "Pré-en-tête affiché avec l’organisation cible dans l’aperçu d’une bibliothèque cliente."
          }
        }
      },
      "EmailTemplateImportResult": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EmailTemplate"
          },
          "alreadyImported": {
            "type": "boolean",
            "description": "true si cette version publiée précise avait déjà été importée ; aucun doublon n’a été créé."
          }
        }
      },
      "CaisseUpdateInput": {
        "type": "object",
        "description": "Mise à jour partielle de cagnotte. Seuls les champs fournis sont modifiés ; aucun champ n’est obligatoire.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Nom public de la cagnotte (obligatoire à la création)."
          },
          "label": {
            "type": "string",
            "description": "Libellé interne (nom par défaut)."
          },
          "objectif": {
            "type": "number",
            "description": "Objectif de collecte en unités MAJEURES (par ex. euros)."
          },
          "withObjectif": {
            "type": "boolean",
            "description": "Afficher une barre de progression vers l’objectif."
          },
          "marge": {
            "type": "number",
            "description": "Frais/marge appliqués (0 par défaut)."
          },
          "bgimage": {
            "type": "string",
            "description": "Image d’arrière-plan : URL http(s) (réhébergée côté serveur) ou nom de fichier déjà hébergé."
          },
          "assoc": {
            "type": "string",
            "description": "Identifiant de l’association juridique (\"MAIN\" par défaut)."
          },
          "typeId": {
            "type": "string",
            "description": "Identifiant du livret/PE auquel rattacher la cagnotte, ou \"AUTO\" pour une cagnotte autonome (rattachée à elle-même)."
          },
          "cerfa": {
            "type": "boolean",
            "description": "Indique si les dons versés dans cette cagnotte donnent lieu à un reçu fiscal (true par défaut)."
          },
          "url": {
            "type": "string",
            "description": "Slug personnalisé de l’URL publique de la page de la cagnotte."
          },
          "hidden": {
            "type": "boolean",
            "description": "Masquer la cagnotte des listes publiques."
          },
          "presetButtons": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Montants de don prédéfinis proposés aux donateurs."
          },
          "imagesCaroussel": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Carrousel d’images : chaque entrée est une URL http(s) (réhébergée) ou un nom de fichier déjà hébergé."
          },
          "textContent": {
            "type": "string",
            "description": "Contenu enrichi de la page."
          },
          "youtubeId": {
            "type": "string",
            "description": "Identifiant de la vidéo YouTube affichée sur la page."
          },
          "aiContentBlockId": {
            "type": "string",
            "description": "Identifiant du bloc de contenu IA associé."
          },
          "pe": {
            "type": "string",
            "description": "Identifiant de session Parcours d'Événement auquel rattacher cette cagnotte."
          }
        }
      },
      "FormUpdateInput": {
        "type": "object",
        "description": "Mise à jour partielle de définition de formulaire. Seuls les champs fournis sont modifiés ; aucun champ n’est obligatoire.",
        "properties": {
          "title": {
            "type": "string",
            "description": "Titre public du formulaire (obligatoire)."
          },
          "url": {
            "type": "string",
            "description": "Slug public (minuscules, sans accents, espaces remplacés par \"-\"). Facultatif."
          },
          "description": {
            "type": "string",
            "description": "Description interne (visible par l’admin uniquement)."
          },
          "afficheUrl": {
            "type": "string",
            "description": "URL de l’affiche/de l’image de couverture ou nom du fichier hébergé, affiché en haut du formulaire. Ajoute les métadonnées de partage WhatsApp. Envoyez \"\" pour la supprimer. Peut coexister avec aiContentBlockId (les deux peuvent être définis)."
          },
          "aiContentBlockId": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant d’un bloc de contenu IA (ai_content_blocks), affiché sous forme de bannière HTML enrichie tout en haut du formulaire, au-dessus des champs d’identité. Facultatif — omettre pour ne pas modifier ; envoyer \"\"/null pour le supprimer. Indépendant de afficheUrl (l’image d’affiche) : un formulaire peut afficher les deux."
          },
          "autoValid": {
            "type": "boolean",
            "description": "true = soumissions validées automatiquement ; false = validation manuelle."
          },
          "withPaiement": {
            "type": "boolean",
            "description": "Activer le paiement en ligne. Si false, tous les champs de paiement ci-dessous sont ignorés."
          },
          "paiementType": {
            "type": "string",
            "enum": [
              "PAIEMENT",
              "ABONNEMENT",
              "MONTHLY"
            ],
            "description": "Modèle de facturation : PAIEMENT = paiement ponctuel ; ABONNEMENT = versements limités ; MONTHLY = paiement mensuel récurrent. Nécessite withPaiement=true."
          },
          "onePaiement": {
            "type": "boolean",
            "description": "Imposer un paiement unique (sans acompte). Uniquement avec paiementType=PAIEMENT."
          },
          "deposit": {
            "type": "number",
            "description": "Montant fixe de l’acompte. paiementType=PAIEMENT et onePaiement=false."
          },
          "depositPercent": {
            "type": "number",
            "description": "Acompte en pourcentage (0-100). Même dépendance que `deposit`."
          },
          "abonnementMaxMonth": {
            "type": "integer",
            "description": "Nombre maximal de versements (≥2). paiementType=ABONNEMENT."
          },
          "aboMonthInfinite": {
            "type": "boolean",
            "description": "Abonnement sans date de fin. paiementType=MONTHLY."
          },
          "aboMonthMin": {
            "type": "integer",
            "description": "Nombre minimal de mois d’abonnement (≥1). MONTHLY + aboMonthInfinite=false."
          },
          "aboMonthMax": {
            "type": "integer",
            "description": "Nombre maximal de mois d’abonnement (≥ aboMonthMin). MONTHLY + aboMonthInfinite=false."
          },
          "paiementMethods": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Autres moyens de paiement manuels possibles, par ex. [\"CHEQUE\",\"VIREMENT\",\"ESPECES\"]."
          },
          "requirePaiementValidation": {
            "type": "boolean",
            "description": "Validation conditionnée au paiement en ligne. Nécessite withPaiement=true."
          },
          "autoValidOtherPaiementMethod": {
            "type": "boolean",
            "description": "Valider automatiquement les paiements par un autre moyen. Nécessite requirePaiementValidation=true."
          },
          "allowZeroAmount": {
            "type": "boolean",
            "description": "Autoriser une soumission dont le total est égal à 0."
          },
          "identity": {
            "type": "string",
            "enum": [
              "SIMPLE"
            ],
            "description": "Niveau d’identification du contact. SIMPLE = nom complet + email + téléphone."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Catégories CRM appliquées automatiquement à chaque contact ayant soumis le formulaire."
          },
          "globalStock": {
            "type": "integer",
            "nullable": true,
            "description": "Stock partagé qui remplace les stocks définis par produit."
          },
          "allowNoProduct": {
            "type": "boolean",
            "description": "Autoriser l’envoi d’une soumission sans sélectionner de produit."
          },
          "products": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FormProductInput"
            },
            "description": "Articles pouvant être achetés. Utilisez des produits distincts pour des prix différents."
          },
          "additionalFields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FormAdditionalField"
            },
            "description": "Champs personnalisés globaux (une fois par soumission)."
          }
        }
      },
      "PageUpdateInput": {
        "type": "object",
        "description": "Mise à jour partielle des métadonnées et du SEO d’une page. Seuls les champs fournis sont modifiés, y compris dans les surcharges SEO des autres langues ; aucun champ n’est obligatoire. Les champs SEO null/vides rétablissent les valeurs par défaut du site, puis les valeurs automatiques. Les champs de la langue par défaut restent à la racine.",
        "properties": {
          "label": {
            "type": "string",
            "description": "Libellé interne."
          },
          "title": {
            "type": "string",
            "description": "Titre public de la page (obligatoire à la création)."
          },
          "description": {
            "type": "string",
            "description": "Description de la page ; valeur SEO de repli automatique lorsqu’aucune description SEO de page/site n’est définie."
          },
          "metaTitle": {
            "type": "string",
            "nullable": true,
            "description": "Titre SEO et de partage propre à la page ; remplace la valeur par défaut du site sans modifier le titre visible. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "metaDescription": {
            "type": "string",
            "nullable": true,
            "description": "Description meta et de partage propre à la page ; remplace la valeur par défaut du site. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "metaImage": {
            "type": "string",
            "nullable": true,
            "description": "Image de partage propre à la page : URL HTTP(S) (réhébergée côté serveur) ou nom de fichier déjà hébergé, y compris les images traduites. Null ou une chaîne vide supprime cette personnalisation et rétablit la valeur de repli du site/automatique."
          },
          "fr": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "en": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "he": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "it": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "ru": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "pt": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "de": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "es": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "gr": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "ro": {
            "$ref": "#/components/schemas/PageSeoOverlay"
          },
          "url": {
            "type": "string",
            "description": "URL de la page, par ex. \"infos/horaires\" (obligatoire à la création). Normalisée côté serveur en segments de slug ; doit être unique et ne pas entrer en conflit avec une page intégrée. L’URL de la page d’accueil ne peut pas être modifiée."
          },
          "active": {
            "type": "boolean",
            "description": "Indique si la page est publiée (true par défaut)."
          }
        }
      }
    },
    "parameters": {
      "IdParam": {
        "name": "id",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid",
          "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
        },
        "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
      },
      "ContentBlockIdParam": {
        "name": "id",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string"
        },
        "description": "Identifiant de bloc de contenu — toute chaîne stable de votre choix (UUID recommandé ; générez-en un avec GET /utils/uuid). PUT /content-blocks/{id}/content effectue un upsert ; cet identifiant n’a donc pas besoin d’exister au préalable."
      },
      "VirtualIdParam": {
        "name": "virtualId",
        "in": "query",
        "schema": {
          "type": "string"
        },
        "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
      },
      "LimitParam": {
        "name": "limit",
        "in": "query",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "maximum": 200,
          "default": 50
        },
        "description": "Nombre de résultats par page."
      },
      "CursorParam": {
        "name": "cursor",
        "in": "query",
        "schema": {
          "type": "string"
        },
        "description": "Curseur opaque renvoyé par la requête précédente."
      },
      "CreatedAfterParam": {
        "name": "createdAfter",
        "in": "query",
        "schema": {
          "type": "string",
          "format": "date-time"
        },
        "description": "Filtre : créé après cette date (ISO 8601)."
      },
      "CreatedBeforeParam": {
        "name": "createdBefore",
        "in": "query",
        "schema": {
          "type": "string",
          "format": "date-time"
        },
        "description": "Filtre : créé avant cette date (ISO 8601)."
      }
    }
  }
}
````

### Webhooks

```json
{
  "fundraising.created": {
    "post": {
      "summary": "Événement de campagne de dons (campaignId, métadonnées sûres ; les événements de statistiques sont regroupés par temporisation)",
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/WebhookEventEnvelope"
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Réception confirmée (OK)"
        }
      }
    }
  },
  "fundraising.updated": {
    "post": {
      "summary": "Événement de campagne de dons (campaignId, métadonnées sûres ; les événements de statistiques sont regroupés par temporisation)",
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/WebhookEventEnvelope"
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Réception confirmée (OK)"
        }
      }
    }
  },
  "fundraising.published": {
    "post": {
      "summary": "Événement de campagne de dons (campaignId, métadonnées sûres ; les événements de statistiques sont regroupés par temporisation)",
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/WebhookEventEnvelope"
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Réception confirmée (OK)"
        }
      }
    }
  },
  "fundraising.paused": {
    "post": {
      "summary": "Événement de campagne de dons (campaignId, métadonnées sûres ; les événements de statistiques sont regroupés par temporisation)",
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/WebhookEventEnvelope"
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Réception confirmée (OK)"
        }
      }
    }
  },
  "fundraising.resumed": {
    "post": {
      "summary": "Événement de campagne de dons (campaignId, métadonnées sûres ; les événements de statistiques sont regroupés par temporisation)",
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/WebhookEventEnvelope"
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Réception confirmée (OK)"
        }
      }
    }
  },
  "fundraising.archived": {
    "post": {
      "summary": "Événement de campagne de dons (campaignId, métadonnées sûres ; les événements de statistiques sont regroupés par temporisation)",
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/WebhookEventEnvelope"
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Réception confirmée (OK)"
        }
      }
    }
  },
  "fundraising.stats.changed": {
    "post": {
      "summary": "Événement de campagne de dons (campaignId, métadonnées sûres ; les événements de statistiques sont regroupés par temporisation)",
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/WebhookEventEnvelope"
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Réception confirmée (OK)"
        }
      }
    }
  },
  "fundraising.donation.recorded": {
    "post": {
      "summary": "Événement de campagne de dons (campaignId, métadonnées sûres ; les événements de statistiques sont regroupés par temporisation)",
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/WebhookEventEnvelope"
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Réception confirmée (OK)"
        }
      }
    }
  },
  "fundraising.donation.completed": {
    "post": {
      "summary": "Événement de campagne de dons (campaignId, métadonnées sûres ; les événements de statistiques sont regroupés par temporisation)",
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/WebhookEventEnvelope"
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Réception confirmée (OK)"
        }
      }
    }
  },
  "fundraising.donation.refunded": {
    "post": {
      "summary": "Événement de campagne de dons (campaignId, métadonnées sûres ; les événements de statistiques sont regroupés par temporisation)",
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/WebhookEventEnvelope"
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Réception confirmée (OK)"
        }
      }
    }
  },
  "fundraising.pledge.updated": {
    "post": {
      "summary": "Événement de campagne de dons (campaignId, métadonnées sûres ; les événements de statistiques sont regroupés par temporisation)",
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/WebhookEventEnvelope"
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Réception confirmée (OK)"
        }
      }
    }
  },
  "fundraising.contribution.updated": {
    "post": {
      "summary": "Événement de campagne de dons (campaignId, métadonnées sûres ; les événements de statistiques sont regroupés par temporisation)",
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/WebhookEventEnvelope"
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Réception confirmée (OK)"
        }
      }
    }
  },
  "fundraising.participation.updated": {
    "post": {
      "summary": "Événement de campagne de dons (campaignId, métadonnées sûres ; les événements de statistiques sont regroupés par temporisation)",
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/WebhookEventEnvelope"
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Réception confirmée (OK)"
        }
      }
    }
  },
  "fundraising.subscription.canceled": {
    "post": {
      "summary": "Événement de campagne de dons (campaignId, métadonnées sûres ; les événements de statistiques sont regroupés par temporisation)",
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/WebhookEventEnvelope"
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Réception confirmée (OK)"
        }
      }
    }
  },
  "paiement.success": {
    "post": {
      "summary": "Un paiement vient d’être encaissé",
      "description": "Unisoft envoie une requête HTTP POST avec Content-Type: application/json à l’URL HTTPS configurée dans Developers > Outbound webhooks. Le secret d’intégration n’est affiché qu’une seule fois, à la création ou à la rotation ; aucune clé API n’est envoyée à votre opération.\n\nVérifiez `X-Unisoft-Signature` par rapport à `\"sha256=\" + hex(HMAC-SHA256(secret, X-Unisoft-Timestamp + \".\" + rawBody))`. Utilisez les octets exacts de la requête brute, AVANT l’analyse du JSON (les fonctions HTTPS Firebase exposent `req.rawBody`). Utilisez une comparaison résistante aux attaques temporelles et rejetez les horodatages non numériques ou obsolètes ; la tolérance recommandée est de 300 secondes. L’horodatage est en secondes Unix et est renouvelé à chaque tentative.\n\nAccusez réception avec n’importe quelle réponse 2xx dans les 10 secondes ; le corps de la réponse est ignoré. Enregistrez l’événement ou placez-le en file avant l’accusé de réception, puis traitez-le de façon asynchrone. Dédupliquez par l’identifiant de l’enveloppe (également `X-Unisoft-Event-Id`) ; il reste stable lors des nouvelles tentatives de livraison, tandis que `attempt` augmente. `createdAt` est la date de mise en file, pas nécessairement la date du paiement. Les livraisons peuvent être dupliquées ou arriver dans le désordre.\n\nLes erreurs réseau, délais d’attente dépassés, réponses 5xx, 408 et 429 entraînent de nouvelles tentatives, jusqu’à 6. Les autres réponses 4xx sont définitives. Après 20 échecs consécutifs de l’intégration, la destination est mise en quarantaine pendant 24 heures. La livraison n’est pas garantie sans limite ; rapprochez les données avec GET /paiements si nécessaire.\n\nLes données de paiement sont un instantané du paiement au moment de l’émission, et non un événement bancaire normalisé. `amount` est exprimé en unités mineures, `devise` indique la devise, `contact` est un identifiant de contact (pas un objet contact) et `info` contient l’identité du donateur. Les champs supplémentaires varient selon le fournisseur et le type. `externalRef` et `externalMetadata` sont inclus s’ils existent ; les anciens paiements peuvent ne pas les contenir. Ne vous fiez pas aux champs propres à un fournisseur. Ces charges utiles peuvent contenir des données personnelles.\n\nÉmis lorsqu’un paiement est terminé avec succès, y compris les paiements récurrents. Le nom de l’événement signale la fin du traitement ; les champs d’instantané peuvent varier selon le fournisseur et le type.",
      "parameters": [
        {
          "name": "X-Unisoft-Event",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string",
            "enum": [
              "paiement.success"
            ]
          },
          "description": "Type d’événement ; identique à type dans le corps."
        },
        {
          "name": "X-Unisoft-Event-Id",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "Identifiant d’événement stable ; identique à id dans le corps."
        },
        {
          "name": "X-Unisoft-Delivery-Id",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string",
            "format": "uuid"
          },
          "description": "Identifiant de l’enregistrement de livraison pour cette destination ; stable lors de ses nouvelles tentatives."
        },
        {
          "name": "X-Unisoft-Timestamp",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "description": "Secondes Unix, incluses dans les données signées."
        },
        {
          "name": "X-Unisoft-Signature",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string",
            "pattern": "^sha256=[0-9a-f]{64}$"
          },
          "description": "Signature HMAC SHA-256 calculée avec ce secret d’intégration."
        }
      ],
      "requestBody": {
        "required": true,
        "content": {
          "application/json": {
            "schema": {
              "allOf": [
                {
                  "$ref": "#/components/schemas/WebhookEventEnvelope"
                },
                {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "enum": [
                        "paiement.success"
                      ]
                    },
                    "data": {
                      "$ref": "#/components/schemas/Paiement"
                    }
                  }
                }
              ]
            },
            "example": {
              "id": "800efee9-9414-4392-98d0-2ebf6759f617",
              "type": "paiement.success",
              "organisation": "org_example",
              "createdAt": "2026-10-16T11:00:00.000Z",
              "attempt": 1,
              "data": {
                "id": "cf161b09-6bab-4a24-9c7b-c8f223b18c09",
                "organisation": "org_example",
                "name": "Donation",
                "state": "COMPLETED",
                "type": "GENERAL",
                "platform": "STRIPE",
                "method": "CB",
                "amount": 1500,
                "devise": "eur",
                "contact": "contact_example",
                "info": {
                  "prenom": "Sarah",
                  "nom": "Cohen",
                  "email": "sarah@example.org",
                  "tel": ""
                },
                "datetime": "2026-10-16T10:00:00.000Z",
                "externalRef": "commande-1234",
                "externalMetadata": {
                  "registrationId": "inscription-567",
                  "eventId": "chabbat-890"
                }
              }
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Événement accepté durablement. Toute réponse 2xx est acceptée ; le corps de la réponse est ignoré."
        }
      }
    }
  },
  "paiement.refunded": {
    "post": {
      "summary": "Un paiement a été remboursé",
      "description": "Unisoft envoie une requête HTTP POST avec Content-Type: application/json à l’URL HTTPS configurée dans Developers > Outbound webhooks. Le secret d’intégration n’est affiché qu’une seule fois, à la création ou à la rotation ; aucune clé API n’est envoyée à votre opération.\n\nVérifiez `X-Unisoft-Signature` par rapport à `\"sha256=\" + hex(HMAC-SHA256(secret, X-Unisoft-Timestamp + \".\" + rawBody))`. Utilisez les octets exacts de la requête brute, AVANT l’analyse du JSON (les fonctions HTTPS Firebase exposent `req.rawBody`). Utilisez une comparaison résistante aux attaques temporelles et rejetez les horodatages non numériques ou obsolètes ; la tolérance recommandée est de 300 secondes. L’horodatage est en secondes Unix et est renouvelé à chaque tentative.\n\nAccusez réception avec n’importe quelle réponse 2xx dans les 10 secondes ; le corps de la réponse est ignoré. Enregistrez l’événement ou placez-le en file avant l’accusé de réception, puis traitez-le de façon asynchrone. Dédupliquez par l’identifiant de l’enveloppe (également `X-Unisoft-Event-Id`) ; il reste stable lors des nouvelles tentatives de livraison, tandis que `attempt` augmente. `createdAt` est la date de mise en file, pas nécessairement la date du paiement. Les livraisons peuvent être dupliquées ou arriver dans le désordre.\n\nLes erreurs réseau, délais d’attente dépassés, réponses 5xx, 408 et 429 entraînent de nouvelles tentatives, jusqu’à 6. Les autres réponses 4xx sont définitives. Après 20 échecs consécutifs de l’intégration, la destination est mise en quarantaine pendant 24 heures. La livraison n’est pas garantie sans limite ; rapprochez les données avec GET /paiements si nécessaire.\n\nLes données de paiement sont un instantané du paiement au moment de l’émission, et non un événement bancaire normalisé. `amount` est exprimé en unités mineures, `devise` indique la devise, `contact` est un identifiant de contact (pas un objet contact) et `info` contient l’identité du donateur. Les champs supplémentaires varient selon le fournisseur et le type. `externalRef` et `externalMetadata` sont inclus s’ils existent ; les anciens paiements peuvent ne pas les contenir. Ne vous fiez pas aux champs propres à un fournisseur. Ces charges utiles peuvent contenir des données personnelles.\n\nÉmis après confirmation d’un remboursement ; `data` contient le paiement d’origine avec l’état de remboursement mis à jour. `amount` reste le montant du paiement initial, pas un montant de remboursement distinct. À distinguer de la réponse synchrone de POST /paiements/{id}/refund.",
      "parameters": [
        {
          "name": "X-Unisoft-Event",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string",
            "enum": [
              "paiement.refunded"
            ]
          },
          "description": "Type d’événement ; identique à type dans le corps."
        },
        {
          "name": "X-Unisoft-Event-Id",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "Identifiant d’événement stable ; identique à id dans le corps."
        },
        {
          "name": "X-Unisoft-Delivery-Id",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string",
            "format": "uuid"
          },
          "description": "Identifiant de l’enregistrement de livraison pour cette destination ; stable lors de ses nouvelles tentatives."
        },
        {
          "name": "X-Unisoft-Timestamp",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "description": "Secondes Unix, incluses dans les données signées."
        },
        {
          "name": "X-Unisoft-Signature",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string",
            "pattern": "^sha256=[0-9a-f]{64}$"
          },
          "description": "Signature HMAC SHA-256 calculée avec ce secret d’intégration."
        }
      ],
      "requestBody": {
        "required": true,
        "content": {
          "application/json": {
            "schema": {
              "allOf": [
                {
                  "$ref": "#/components/schemas/WebhookEventEnvelope"
                },
                {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "enum": [
                        "paiement.refunded"
                      ]
                    },
                    "data": {
                      "$ref": "#/components/schemas/Paiement"
                    }
                  }
                }
              ]
            },
            "example": {
              "id": "800efee9-9414-4392-98d0-2ebf6759f617",
              "type": "paiement.refunded",
              "organisation": "org_example",
              "createdAt": "2026-10-16T11:00:00.000Z",
              "attempt": 1,
              "data": {
                "id": "cf161b09-6bab-4a24-9c7b-c8f223b18c09",
                "organisation": "org_example",
                "name": "Donation",
                "state": "REFUNDED",
                "type": "GENERAL",
                "platform": "STRIPE",
                "method": "CB",
                "amount": 1500,
                "devise": "eur",
                "contact": "contact_example",
                "info": {
                  "prenom": "Sarah",
                  "nom": "Cohen",
                  "email": "sarah@example.org",
                  "tel": ""
                },
                "datetime": "2026-10-16T10:00:00.000Z",
                "externalRef": "commande-1234",
                "externalMetadata": {
                  "registrationId": "inscription-567",
                  "eventId": "chabbat-890"
                },
                "refund": {
                  "state": "SUCCEEDED",
                  "reason": "requested_by_customer",
                  "updatedAt": "2026-10-16T11:00:00.000Z"
                }
              }
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Événement accepté durablement. Toute réponse 2xx est acceptée ; le corps de la réponse est ignoré."
        }
      }
    }
  },
  "webhook.test": {
    "post": {
      "summary": "Test de connectivité synthétique (aucune opération financière)",
      "description": "Unisoft envoie une requête HTTP POST avec Content-Type: application/json à l’URL HTTPS configurée dans Developers > Outbound webhooks. Le secret d’intégration n’est affiché qu’une seule fois, à la création ou à la rotation ; aucune clé API n’est envoyée à votre opération.\n\nVérifiez `X-Unisoft-Signature` par rapport à `\"sha256=\" + hex(HMAC-SHA256(secret, X-Unisoft-Timestamp + \".\" + rawBody))`. Utilisez les octets exacts de la requête brute, AVANT l’analyse du JSON (les fonctions HTTPS Firebase exposent `req.rawBody`). Utilisez une comparaison résistante aux attaques temporelles et rejetez les horodatages non numériques ou obsolètes ; la tolérance recommandée est de 300 secondes. L’horodatage est en secondes Unix et est renouvelé à chaque tentative.\n\nAccusez réception avec n’importe quelle réponse 2xx dans les 10 secondes ; le corps de la réponse est ignoré. Enregistrez l’événement ou placez-le en file avant l’accusé de réception, puis traitez-le de façon asynchrone. Dédupliquez par l’identifiant de l’enveloppe (également `X-Unisoft-Event-Id`) ; il reste stable lors des nouvelles tentatives de livraison, tandis que `attempt` augmente. `createdAt` est la date de mise en file, pas nécessairement la date du paiement. Les livraisons peuvent être dupliquées ou arriver dans le désordre.\n\nLes erreurs réseau, délais d’attente dépassés, réponses 5xx, 408 et 429 entraînent de nouvelles tentatives, jusqu’à 6. Les autres réponses 4xx sont définitives. Après 20 échecs consécutifs de l’intégration, la destination est mise en quarantaine pendant 24 heures. La livraison n’est pas garantie sans limite ; rapprochez les données avec GET /paiements si nécessaire.\n\nLes données de paiement sont un instantané du paiement au moment de l’émission, et non un événement bancaire normalisé. `amount` est exprimé en unités mineures, `devise` indique la devise, `contact` est un identifiant de contact (pas un objet contact) et `info` contient l’identité du donateur. Les champs supplémentaires varient selon le fournisseur et le type. `externalRef` et `externalMetadata` sont inclus s’ils existent ; les anciens paiements peuvent ne pas les contenir. Ne vous fiez pas aux champs propres à un fournisseur. Ces charges utiles peuvent contenir des données personnelles.\n\nLe bouton Test du back-office envoie cet événement synthétique via la file de livraison signée habituelle, indépendamment de la liste des événements auxquels on est abonné. Il ne crée, n’encaisse ni ne rembourse aucun paiement.",
      "parameters": [
        {
          "name": "X-Unisoft-Event",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string",
            "enum": [
              "webhook.test"
            ]
          },
          "description": "Type d’événement ; identique à type dans le corps."
        },
        {
          "name": "X-Unisoft-Event-Id",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "Identifiant d’événement stable ; identique à id dans le corps."
        },
        {
          "name": "X-Unisoft-Delivery-Id",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string",
            "format": "uuid"
          },
          "description": "Identifiant de l’enregistrement de livraison pour cette destination ; stable lors de ses nouvelles tentatives."
        },
        {
          "name": "X-Unisoft-Timestamp",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string",
            "pattern": "^[0-9]+$"
          },
          "description": "Secondes Unix, incluses dans les données signées."
        },
        {
          "name": "X-Unisoft-Signature",
          "in": "header",
          "required": true,
          "schema": {
            "type": "string",
            "pattern": "^sha256=[0-9a-f]{64}$"
          },
          "description": "Signature HMAC SHA-256 calculée avec ce secret d’intégration."
        }
      ],
      "requestBody": {
        "required": true,
        "content": {
          "application/json": {
            "schema": {
              "allOf": [
                {
                  "$ref": "#/components/schemas/WebhookEventEnvelope"
                },
                {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string",
                      "enum": [
                        "webhook.test"
                      ]
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "test": {
                          "type": "boolean",
                          "enum": [
                            true
                          ]
                        },
                        "triggeredBy": {
                          "type": "string",
                          "nullable": true
                        },
                        "message": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              ]
            },
            "example": {
              "id": "800efee9-9414-4392-98d0-2ebf6759f617",
              "type": "webhook.test",
              "organisation": "org_example",
              "createdAt": "2026-10-16T11:00:00.000Z",
              "attempt": 1,
              "data": {
                "test": true,
                "triggeredBy": null,
                "message": "This is a test event sent from the Unisoft backoffice."
              }
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Événement accepté durablement. Toute réponse 2xx est acceptée ; le corps de la réponse est ignoré."
        }
      }
    }
  },
  "form.submitted": {
    "post": {
      "summary": "Un formulaire vient d’être soumis",
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/WebhookEventEnvelope"
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Réception confirmée (OK)"
        }
      }
    }
  },
  "contact.created": {
    "post": {
      "summary": "Un nouveau contact (donateur/membre) a été créé",
      "requestBody": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/WebhookEventEnvelope"
            }
          }
        }
      },
      "responses": {
        "200": {
          "description": "Réception confirmée (OK)"
        }
      }
    }
  }
}
```
