**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)

# Événements annuels

OpenAPI 3.0.3 · API 1.0.0

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

Événements gérés : création à partir de données structurées ou d’une affiche, publication de la page publique, du formulaire d’inscription et/ou de la cagnotte, puis préparation d’un brouillon de campagne. Les événements Shabbat et de fêtes préfabriqués sont volontairement exclus de cette API. Autorisations : `events:read` / `events:write`.

## Opérations

## 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
  }
}
```

## Schémas

```json
{
  "components": {
    "parameters": {
      "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."
      }
    },
    "schemas": {
      "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"
              }
            }
          }
        ]
      },
      "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"
          }
        }
      },
      "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"
            }
          }
        }
      },
      "AnnualEventOperationalState": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "registration": {
            "$ref": "#/components/schemas/AnnualEventRegistrationState"
          }
        },
        "required": [
          "registration"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "nextCursor": {
            "type": "string",
            "nullable": true
          },
          "hasMore": {
            "type": "boolean"
          },
          "count": {
            "type": "integer"
          }
        }
      },
      "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"
        ]
      },
      "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"
        ]
      },
      "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"
          }
        }
      },
      "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": []
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
