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

# Événements annuels

OpenAPI 3.0.3 · API 2.0.0

```json
[
  {
    "url": "https://api.unisoft.world/integrations/v2",
    "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/UnisoftRequest_133a453e99d95d23090e"
      }
    }
  }
}
```

### 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": {
        "type": "object",
        "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"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### 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",
        "properties": {
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "patch": {
            "$ref": "#/components/schemas/UnisoftRequest_95690b6a2d37403c8838"
          },
          "idempotencyKey": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "timeZone": {
            "type": "string"
          }
        },
        "required": [
          "expectedRevision",
          "patch",
          "idempotencyKey"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

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

## POST /annual-events/{id}/series-plan

Prévisualiser les séances exactes et les effets de réapplication canonique d’une série gérée

`preview_event_series_change`

Autorisations : events:read avec forms:read/caisses:read/messages:read selon les ressources liées, y compris celles conservées en historique, et content_blocks:read si nécessaire. Plan en lecture seule : aucun appel au moteur de publication, chargement de média, traduction, écriture de ressource/cache, inscription ou prestataire. Retourne les instants UTC exacts actuels et suivants, états active, identifiants sélectionnés/retirés, clés ajoutées, autorisations nécessaires et changements de cible publique. Lire tous les effets de réapplication et les limites sur les modifications manuelles avant toute décision. Seuls les projets annuels ordinaires gérés, actuellement publiés sur le site principal admis, sont pris en charge. Les groupes Chabbat/préfabriqués protégés, projets dépubliés et contextes de façade non prouvés sont refusés. Un identifiant de projet n’est pas un identifiant de groupe, séance ou formulaire. ADD_DATES ajoute des dates civiles explicites aux horaires communs existants. REMOVE_SESSIONS cible des identifiants de séance EXPLICIT ou FROM_SESSION : séance d’ancrage et suivantes, inclusivement, selon leurs instants natifs, indépendamment de la date actuelle. SET_RECURRENCE utilise le moteur natif once/weekly/monthly/custom avec ALL ou FROM_SESSION ; les dates antérieures non sélectionnées restent égales et les dates générées avant l’ancrage sont refusées. Aucun nouveau fuseau ni nouvel horaire n’est accepté. ADD/REMOVE et le remplacement ciblé conservent les dates exactes en custom, ou once s’il n’en reste qu’une ; ALL conserve la cadence native choisie. Au maximum 200 séances subsistent. Collisions de clés logiques actuelles ou retirées, calendrier vide, dérive de date, changement de devise/fuseau et données inconnues sont refusés. Les ressources/références existantes doivent avoir des identités scalaires globalement uniques ; les futurs identifiants enfants stables natifs doivent être absents globalement avant publication. Une correspondance locale à l’organisation ne suffit pas à contourner un alias. Les clés logiques conservées gardent leurs identifiants de séance ; les nouveaux identifiants restent null dans le plan jusqu’à leur création par le propriétaire. active distingue les séances conservées désactivées des nouvelles séances actives. Les séances PE, formulaires et cagnottes retirés deviennent inactifs ; anciens produits et livrets restent conservés dans leur état natif. Aucune inscription, billet ou paiement n’est supprimé, aucun remboursement ni révocation de scan n’est effectué. Le moteur natif réapplique la configuration canonique à TOUTES les séances, formulaires, produits et cagnottes conservés ainsi qu’à une campagne préparée, pas seulement à la sélection. La conservation des modifications manuelles n’est PAS garantie ; la commande relue exige donc confirmCanonicalRefresh=true. La cible publique peut changer, notamment entre page de groupe et première séance : lire le plan. Aucune campagne n’est envoyée. Utiliser reschedule_event_session pour reporter une date en préservant l’identité ; ce remplacement de composition n’est pas équivalent. Lectures et plans restent des observations optimistes, sans réservation ni transaction globale contre les écritures internes.

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

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "change": {
            "$ref": "#/components/schemas/UnisoftRequest_0667b8aac019eb4d0f07"
          }
        },
        "required": [
          "change"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Plan de série natif relu ou accusé enregistré du propriétaire.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/EventSeriesPlan"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_SERIES_INPUT / INVALID_EVENT_SERIES_SCHEDULE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_NOT_FOUND / EVENT_REFERENCE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REVISION_CONFLICT / IDEMPOTENCY_KEY_CONFLICT / EVENT_SERIES_PLAN_CHANGED / EVENT_SERIES_UNSUPPORTED / EVENT_SERIES_NOT_PUBLIC / INVALID_EVENT_GRAPH / EVENT_WRITE_UNCERTAIN / EVENT_PUBLICATION_UNCERTAIN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "EVENT_SERIES_UNAVAILABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## POST /annual-events/{id}/series

Appliquer une modification de composition de série relue via son moteur natif

`change_event_series`

Autorisations : events:write et events:read avec forms:write/caisses:write/messages:write selon les ressources liées et content_blocks:read si nécessaire. Les autorisations de domaine s’appliquent aussi aux ressources historiques que le propriétaire peut désactiver, dont une ancienne campagne préparée. Lire d’abord preview_event_series_change, puis fournir change identique, planHash, expectedRevision native, idempotencyKey stable et confirmCanonicalRefresh=true. Source, autorisations et plan sont réadmis avant la prise durable du journal externe ; le moteur annuel canonique est appelé au maximum une fois. Une relance terminée strictement identique retourne l’accusé enregistré. Les autorisations capturées et la révision source sont liées au planHash initial ; des métadonnées d’admission manquantes, affaiblies ou contradictoires restent incertaines et n’autorisent jamais un rejeu avec une clé moins privilégiée. L’accusé natif complet, son incrément de révision et les identités globales du résultat sont réadmis avant un succès enregistré et lors d’un rejeu terminé. Stockage ou résultat en attente/incertain : conserver commandId/projectId, sans nouvelle clé ni révision forcée ; observer ressources et historique pour réconciliation. Les écritures journal/CAS exigent un acquittement positif exact avec durabilité explicite. Seuls les projets annuels ordinaires gérés, actuellement publiés sur le site principal admis, sont pris en charge. Les groupes Chabbat/préfabriqués protégés, projets dépubliés et contextes de façade non prouvés sont refusés. Un identifiant de projet n’est pas un identifiant de groupe, séance ou formulaire. ADD_DATES ajoute des dates civiles explicites aux horaires communs existants. REMOVE_SESSIONS cible des identifiants de séance EXPLICIT ou FROM_SESSION : séance d’ancrage et suivantes, inclusivement, selon leurs instants natifs, indépendamment de la date actuelle. SET_RECURRENCE utilise le moteur natif once/weekly/monthly/custom avec ALL ou FROM_SESSION ; les dates antérieures non sélectionnées restent égales et les dates générées avant l’ancrage sont refusées. Aucun nouveau fuseau ni nouvel horaire n’est accepté. ADD/REMOVE et le remplacement ciblé conservent les dates exactes en custom, ou once s’il n’en reste qu’une ; ALL conserve la cadence native choisie. Au maximum 200 séances subsistent. Collisions de clés logiques actuelles ou retirées, calendrier vide, dérive de date, changement de devise/fuseau et données inconnues sont refusés. Les ressources/références existantes doivent avoir des identités scalaires globalement uniques ; les futurs identifiants enfants stables natifs doivent être absents globalement avant publication. Une correspondance locale à l’organisation ne suffit pas à contourner un alias. Les clés logiques conservées gardent leurs identifiants de séance ; les nouveaux identifiants restent null dans le plan jusqu’à leur création par le propriétaire. active distingue les séances conservées désactivées des nouvelles séances actives. Les séances PE, formulaires et cagnottes retirés deviennent inactifs ; anciens produits et livrets restent conservés dans leur état natif. Aucune inscription, billet ou paiement n’est supprimé, aucun remboursement ni révocation de scan n’est effectué. Le moteur natif réapplique la configuration canonique à TOUTES les séances, formulaires, produits et cagnottes conservés ainsi qu’à une campagne préparée, pas seulement à la sélection. La conservation des modifications manuelles n’est PAS garantie ; la commande relue exige donc confirmCanonicalRefresh=true. La cible publique peut changer, notamment entre page de groupe et première séance : lire le plan. Aucune campagne n’est envoyée. Utiliser reschedule_event_session pour reporter une date en préservant l’identité ; ce remplacement de composition n’est pas équivalent. Lectures et plans restent des observations optimistes, sans réservation ni transaction globale contre les écritures internes.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "change": {
            "$ref": "#/components/schemas/UnisoftRequest_0667b8aac019eb4d0f07"
          },
          "idempotencyKey": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "planHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "confirmCanonicalRefresh": {
            "type": "boolean",
            "enum": [
              true
            ]
          }
        },
        "required": [
          "change",
          "idempotencyKey",
          "expectedRevision",
          "planHash",
          "confirmCanonicalRefresh"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Plan de série natif relu ou accusé enregistré du propriétaire.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EventSeriesCommandResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_SERIES_INPUT / INVALID_EVENT_SERIES_SCHEDULE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_NOT_FOUND / EVENT_REFERENCE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REVISION_CONFLICT / IDEMPOTENCY_KEY_CONFLICT / EVENT_SERIES_PLAN_CHANGED / EVENT_SERIES_UNSUPPORTED / EVENT_SERIES_NOT_PUBLIC / INVALID_EVENT_GRAPH / EVENT_WRITE_UNCERTAIN / EVENT_PUBLICATION_UNCERTAIN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "EVENT_SERIES_UNAVAILABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "reason": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:write",
  "x-unisoft-additional-scopes": [
    "events:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  }
}
```

## GET /annual-events/{id}/links

Lire les liens publics d’événement et d’inscription avec leurs iframes natifs

`get_event_public_links`

Autorisations requises : `events:read` et `site:read`, avec forms:read ou caisses:read lorsque des ressources gérées liées existent. Observation en lecture seule d’un identifiant de projet annuel ordinaire géré existant, pas d’une séance, d’un formulaire ou d’un billet. Aucun corps de requête ni paramètre inconnu admis. Omettre virtualId pour le site principal ou fournir l’UUID exact d’une façade actuelle ; les identifiants Travel et d’interfaces de devise ne sont pas des façades. Un groupe rattaché à une façade ne peut pas être lu sur un autre site. lang doit être activée pour ce site ; l’omission utilise sa langue native par défaut. embedId identifie facultativement un iframe hôte et n’est pas un identifiant d’accès. La cible de page enregistrée et les cibles d’inscription/cagnotte sont retournées après réadmission des identités scalaires, de l’organisation et des références. L’unicité globale des cibles et les relations parent/enfant des lecteurs publics natifs sont vérifiées : identités étrangères, dupliquées ou de type tableau dans la résolution des formulaires/séances/groupes ou de leurs enfants entraînent un refus, jamais une autorisation de reconstruire manuellement la même URL. Les fenêtres publiques natives de séance/formulaire et les dates de clôture/fin déterminent les liens d’inscription observés ; une cagnotte active indépendamment peut conserver son lien public direct même si la page événement est masquée. WITHHELD retourne url/embed null et ne prouve pas que toutes les anciennes URL ou capacités de paiement sont révoquées. Seuls les états propriétaires PUBLISHED/CREATED sont admis ; CREATED peut ne disposer d’aucune page. Liens personnalisés modifiables, ressources privées et données propriétaires brutes ne sont pas retournés. Les URL utilisent la racine canonique du site et les routes existantes /evenement, /form et /don ; elles ne contiennent aucune clé API, jeton de scan ou de compte ni capacité de paiement. Chaque iframe fourni utilise la route render=embed existante, des attributs échappés et une hauteur fixe de 800px avec défilement normal. Aucun script, pont hôte, redimensionnement automatique, configuration hôte ou intégration de paiement n’est installé par cette lecture. Aucune page n’est chargée, rendue, publiée ou modifiée ; aucune inscription, réservation, paiement, abonnement, billet ou message n’est créé. OBSERVED_OPEN est une observation optimiste des données et fenêtres publiques, pas une preuve de stock, de paiement possible, de rendu navigateur ou d’inscription réussie. publicRenderingVerified=false, stockChecked=false et paymentReadiness=NOT_EVALUATED restent explicites. Ressources manquantes, étrangères, protégées, mal formées ou liées de façon ambiguë sont refusées avant dérivation des URL. Les clés restreintes à des campagnes sont refusées ; un lien inconnu ou indisponible n’autorise jamais la publication ni un repli vers une route interne.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  }
}
```

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "lang",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "fr",
      "en",
      "he",
      "it",
      "ru",
      "pt",
      "de",
      "es",
      "gr",
      "ro"
    ]
  }
}
```

```json
{
  "name": "embedId",
  "in": "query",
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{1,128}$"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observation qualifiée des liens publics et extraits iframe natifs facultatifs.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EventPublicLinksResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_LINK_INPUT / EVENT_LINK_LANGUAGE_NOT_ENABLED",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_LINK_RESOURCE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_EVENT_LINK_GRAPH / EVENT_LINK_SITE_UNPROVEN / EVENT_LINK_PUBLICATION_UNCERTAIN / EVENT_LINK_CLOCK_UNPROVEN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "EVENT_LINKS_UNAVAILABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:read",
  "x-unisoft-additional-scopes": [
    "site:read"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /annual-events/history

Lister les commandes événementielles externes persistées de l’organisation

`list_event_command_history`

Autorisation requise : `events:read`. Observation paginée en lecture seule du véritable journal des commandes événementielles externes, trié par createdAt puis commandId décroissants. Ne reconstruit jamais un historique natif et n’exécute aucune réconciliation. Aucun corps HTTP ni champ de requête inconnu accepté. state et operation filtrent les commandes stockées ; outcome PUBLISHED/CREATED/UNPUBLISHED sélectionne uniquement les lignes SUCCEEDED portant ce résultat enregistré. from est inclusif et to exclusif, en UTC sur la création de la commande, pas sur l’horaire de la séance. limit est 1..100, par défaut 50 ; poursuivre avec nextCursor et les mêmes filtres. Lorsque id est présent, utiliser un identifiant natif de projet annuel ou de brouillon API réellement connu ; les duplications distinguent sourceProjectId et draftId. Un résultat vide ne prouve jamais l’existence de la ressource ni l’absence de transitions. coverage.complete reste false : modifications internes/natives, actions anciennes non capturées et création d’un brouillon privé ne sont pas des commandes de ce journal. L’existence et la visibilité actuelles ne sont pas évaluées. RUNNING/UNCERTAIN n’autorise jamais une nouvelle clé ou une relance automatique ; REFUSED et SUCCEEDED sont des états de commande enregistrés, pas une preuve de paiement, de livraison, de rendu navigateur ou de visibilité actuelle. finishedAt et les révisions absentes restent null. Seuls les identifiants, horodatages et révisions/résultats connus sont renvoyés ; aucune recette, identité privée d’auteur, clé d’idempotence, empreinte, secret prestataire ou snapshot brut de résultat. Les clés restreintes à des campagnes et les identités historiques ambiguës sont refusées.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "state",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "RUNNING",
      "SUCCEEDED",
      "REFUSED",
      "UNCERTAIN"
    ]
  }
}
```

```json
{
  "name": "operation",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "PUBLISH",
      "REPLACE_RECIPE",
      "DUPLICATE_DRAFT",
      "RESCHEDULE",
      "UNPUBLISH",
      "LEGACY_POST",
      "LEGACY_PATCH",
      "SERIES_UPDATE"
    ]
  }
}
```

```json
{
  "name": "outcome",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "PUBLISHED",
      "CREATED",
      "UNPUBLISHED"
    ]
  }
}
```

```json
{
  "name": "from",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Borne basse inclusive de création du journal, comme instant ISO UTC se terminant par Z."
}
```

```json
{
  "name": "to",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Borne haute exclusive de création du journal, comme instant ISO UTC se terminant par Z."
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 100,
    "default": 50
  }
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string",
    "maxLength": 2000
  },
  "description": "nextCursor opaque retourné par la page précédente. Conserver la même organisation/ressource et les mêmes filtres. C’est une position, jamais une autorisation d’accès."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observations persistées de commandes événementielles externes avec couverture partielle explicite.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EventLifecycleHistoryResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_HISTORY_QUERY / INVALID_EVENT_HISTORY_CURSOR / INVALID_EVENT_HISTORY_ID",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_EVENT_COMMAND_HISTORY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /annual-events/{id}/history

Lire les commandes externes persistées liées à un événement ou brouillon API

`get_event_command_history`

Autorisation requise : `events:read`. Observation paginée en lecture seule du véritable journal des commandes événementielles externes, trié par createdAt puis commandId décroissants. Ne reconstruit jamais un historique natif et n’exécute aucune réconciliation. Aucun corps HTTP ni champ de requête inconnu accepté. state et operation filtrent les commandes stockées ; outcome PUBLISHED/CREATED/UNPUBLISHED sélectionne uniquement les lignes SUCCEEDED portant ce résultat enregistré. from est inclusif et to exclusif, en UTC sur la création de la commande, pas sur l’horaire de la séance. limit est 1..100, par défaut 50 ; poursuivre avec nextCursor et les mêmes filtres. Lorsque id est présent, utiliser un identifiant natif de projet annuel ou de brouillon API réellement connu ; les duplications distinguent sourceProjectId et draftId. Un résultat vide ne prouve jamais l’existence de la ressource ni l’absence de transitions. coverage.complete reste false : modifications internes/natives, actions anciennes non capturées et création d’un brouillon privé ne sont pas des commandes de ce journal. L’existence et la visibilité actuelles ne sont pas évaluées. RUNNING/UNCERTAIN n’autorise jamais une nouvelle clé ou une relance automatique ; REFUSED et SUCCEEDED sont des états de commande enregistrés, pas une preuve de paiement, de livraison, de rendu navigateur ou de visibilité actuelle. finishedAt et les révisions absentes restent null. Seuls les identifiants, horodatages et révisions/résultats connus sont renvoyés ; aucune recette, identité privée d’auteur, clé d’idempotence, empreinte, secret prestataire ou snapshot brut de résultat. Les clés restreintes à des campagnes et les identités historiques ambiguës sont refusées.

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

```json
{
  "name": "state",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "RUNNING",
      "SUCCEEDED",
      "REFUSED",
      "UNCERTAIN"
    ]
  }
}
```

```json
{
  "name": "operation",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "PUBLISH",
      "REPLACE_RECIPE",
      "DUPLICATE_DRAFT",
      "RESCHEDULE",
      "UNPUBLISH",
      "LEGACY_POST",
      "LEGACY_PATCH",
      "SERIES_UPDATE"
    ]
  }
}
```

```json
{
  "name": "outcome",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "PUBLISHED",
      "CREATED",
      "UNPUBLISHED"
    ]
  }
}
```

```json
{
  "name": "from",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Borne basse inclusive de création du journal, comme instant ISO UTC se terminant par Z."
}
```

```json
{
  "name": "to",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Borne haute exclusive de création du journal, comme instant ISO UTC se terminant par Z."
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 100,
    "default": 50
  }
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string",
    "maxLength": 2000
  },
  "description": "nextCursor opaque retourné par la page précédente. Conserver la même organisation/ressource et les mêmes filtres. C’est une position, jamais une autorisation d’accès."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Observations persistées de commandes événementielles externes avec couverture partielle explicite.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EventLifecycleHistoryResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_HISTORY_QUERY / INVALID_EVENT_HISTORY_CURSOR / INVALID_EVENT_HISTORY_ID",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_EVENT_COMMAND_HISTORY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## POST /annual-events/drafts

Enregistrer un brouillon privé d’événement ordinaire

`create_event_draft`

Autorisation requise : `events:write`. Enregistre une recette d’événement ordinaire dans un brouillon privé détenu par l’API, de façon idempotente au sein de l’organisation. Ne publie aucune page, ne crée aucune séance, aucun formulaire ou cagnotte, ne réserve aucun stock et n’envoie aucun message. Ce brouillon n’apparaît pas dans la liste des brouillons du navigateur admin. Les prix, objectifs, acomptes et contributions sont en unités monétaires majeures ; aucun encaissement ni conversion de devise n’a lieu ici. idempotencyKey et recipe sont obligatoires ; répéter une entrée inchangée renvoie le même id, tandis qu’une entrée modifiée avec la même clé renvoie IDEMPOTENCY_KEY_CONFLICT (409). Les références connues sont vérifiées avant sauvegarde ; les clés restreintes à des campagnes sont refusées. Un groupe existant doit être un groupe ordinaire autonome. Un bloc de contenu exige aussi content_blocks:read. requestedTimeZone, facultatif, est une demande pour la publication, pas un calendrier effectif. validation porte uniquement sur la recette canonique : INCOMPLETE désigne un brouillon sauvegardé, pas un échec de création ; VALID ne constitue ni une autorisation ni une preuve de publication. Ne pas appeler create_annual_event pour seulement enregistrer un brouillon : cette opération existante publie immédiatement. Le propriétaire actuel de publication ne prend pas en charge le rattachement d’un formulaire existant ; ne pas l’inventer. Une réponse perdue doit être vérifiée avec la même clé et une entrée identique, ou en lisant l’id du brouillon retourné. Chaque écriture de l’adaptateur exige w:1 et j:true. Les réservations de journal exigent acknowledged=true et l’identifiant exact inséré ou créé par upsert ; le CAS exige des compteurs acquittés positivement. Un acquittement absent ou incohérent arrête le traitement avant l’effet suivant et renvoie EVENT_WRITE_UNCERTAIN ou l’incertitude propre à l’opération. Conserver l’identité et la clé, vérifier la situation et ne jamais forcer une nouvelle clé ou révision pour répéter les effets.

### Authentification

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

### Permissions requises

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

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "Clé de corrélation stable fournie par l’appelant pour cette création au sein de l’organisation. Réutiliser la même clé et une charge inchangée après un résultat incertain ; modifier l’entrée avec la même clé renvoie 409."
          },
          "recipe": {
            "$ref": "#/components/schemas/UnisoftRequest_b6493128eea60f41ebb4"
          },
          "requestedTimeZone": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "Fuseau IANA valide facultatif demandé pour une publication ultérieure. Aucun calendrier effectif n’est calculé ni garanti ici ; le propriétaire de publication existant peut privilégier les coordonnées de l’organisation."
          }
        },
        "required": [
          "idempotencyKey",
          "recipe"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Réponse développeur pour un événement ordinaire.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EventLifecycleResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_DRAFT_INPUT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_REFERENCE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "IDEMPOTENCY_KEY_CONFLICT / INVALID_EVENT_DRAFT_HISTORY / PROTECTED_EVENT_GROUP / EVENT_WRITE_UNCERTAIN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "EVENT_DRAFT_UNAVAILABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /annual-events/drafts/{id}

Lire un brouillon privé d’événement ordinaire

`get_event_draft`

Autorisation requise : `events:read`. Lit une recette d’événement ordinaire détenue par l’API et son acquittement externe de publication avec l’UUID retourné. Aucun paramètre de requête ni corps HTTP accepté. Les clés restreintes à des campagnes sont refusées. DRAFT n’a créé aucun projet natif ; après publication explicite, publication.projectId désigne le projet annuel canonique. Les enregistrements logiques restent distincts même lorsque leur UUID est identique. MATERIALIZED correspond à CREATED natif sans page publique ; PUBLICATION_UNCERTAIN exige une vérification et ne prouve jamais la publication. validation vérifie de nouveau la complétude de la recette avec le seul validateur canonique pur ; elle ne revalide pas toutes les dépendances actuelles et n’exécute pas la publication. Les champs absents restent absents. Les recettes détenues par l’API restent distinctes des brouillons locaux du navigateur admin. Les identités étrangères ou ambiguës sont refusées, et les champs privés d’audit ou d’empreinte ne sont jamais retournés.

### 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"
  },
  "description": "UUID d’un brouillon API existant retourné par create_event_draft."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Réponse développeur pour un événement ordinaire.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EventLifecycleResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_DRAFT_ID",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_DRAFT_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_EVENT_DRAFT_HISTORY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## PUT /annual-events/drafts/{id}

Remplacer la recette d’un brouillon API d’événement non publié

`replace_event_draft`

Autorisation requise : `events:write`. Remplace la recette complète d’un DRAFT détenu par l’API, avec expectedRevision explicite et une idempotencyKey stable. Lire d’abord get_event_draft et conserver tous les champs déclarés sans rapport avec la modification : les champs de recette omis sont supprimés, pas fusionnés. Omettre requestedTimeZone conserve la demande existante ; null l’efface explicitement. Cette opération ne republie jamais et ne modifie aucun projet événementiel natif. Seul DRAFT est modifiable ; changer la révision ou la clé ne permet pas de contourner PUBLISHING, PUBLISHED, MATERIALIZED ou PUBLICATION_UNCERTAIN. Les références et content_blocks:read, lorsque nécessaire, sont vérifiés à nouveau avant la mise à jour atomique. La clé initiale de création conserve son identité après les modifications. Répéter une modification terminée inchangée renvoie son acquittement enregistré, qui peut précéder des modifications ultérieures ; relire pour obtenir l’état actuel. Une modification privée incertaine n’est résolue que lorsque le marqueur atomique de la ligne prouve l’application de cette commande exacte ; sinon elle reste incertaine. Les tableaux et objets imbriqués de recipe sont remplacés entièrement, sans mise à jour incrémentale. Chaque écriture de l’adaptateur exige w:1 et j:true. Les réservations de journal exigent acknowledged=true et l’identifiant exact inséré ou créé par upsert ; le CAS exige des compteurs acquittés positivement. Un acquittement absent ou incohérent arrête le traitement avant l’effet suivant et renvoie EVENT_WRITE_UNCERTAIN ou l’incertitude propre à l’opération. Conserver l’identité et la clé, vérifier la situation et ne jamais forcer une nouvelle clé ou révision pour répéter les effets.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "UUID d’un brouillon API existant retourné par create_event_draft."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "recipe": {
            "$ref": "#/components/schemas/UnisoftRequest_b6493128eea60f41ebb4"
          },
          "requestedTimeZone": {
            "type": "string",
            "maxLength": 100,
            "nullable": true
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "recipe"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Réponse développeur pour un événement ordinaire.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EventLifecycleResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_DRAFT_INPUT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_DRAFT_NOT_FOUND / EVENT_REFERENCE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REVISION_CONFLICT / IDEMPOTENCY_KEY_CONFLICT / EVENT_DRAFT_STATE_CONFLICT / EVENT_DRAFT_EDIT_UNCERTAIN / EVENT_WRITE_UNCERTAIN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /annual-events/drafts/{id}/publication-plan

Prévisualiser le plan canonique de publication d’un brouillon d’événement

`get_event_draft_publication_plan`

Autorisation requise : `events:read`. Précontrôle en lecture seule d’un DRAFT détenu par l’API. Résout le fuseau effectif avec le propriétaire canonique, vérifie les instants UTC de ses séances et exige une devise d’organisation prouvée, sans inventer EUR ou Europe/Paris. Un fuseau demandé valide est obligatoire lorsque les coordonnées de l’organisation sont indisponibles. Le planHash et expectedRevision retournés doivent être transmis inchangés à publish_event_draft. Vérifier les instants UTC exacts de début et fin avant publication ; la résolution native des changements d’heure n’est pas remplacée ici. Les références au groupe, au bloc de contenu et à l’affiche hébergée sont réadmises. Un bloc de contenu exige aussi content_blocks:read. Un plan est une observation optimiste, pas une réservation de stock, un octroi de permission ou un verrou contre les écritures internes ; la publication le recalcule. La publication cible le publicBaseUrl principal retourné par ce plan ; aucune autre façade n’est sélectionnée ici. Cette lecture ne crée aucune ressource publique, aucun téléchargement de média, message ou traduction.

### 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"
  },
  "description": "UUID d’un brouillon API existant retourné par create_event_draft."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Réponse développeur pour un événement ordinaire.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/EventLifecyclePublicationPlan"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_DRAFT_NOT_FOUND / EVENT_REFERENCE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "EVENT_DRAFT_STATE_CONFLICT / EVENT_CURRENCY_UNAVAILABLE / EVENT_TIME_ZONE_REQUIRED / EVENT_PUBLIC_SITE_UNAVAILABLE / EVENT_PUBLICATION_CONTEXT_UNAVAILABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "EVENT_DRAFT_NOT_READY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## POST /annual-events/drafts/{id}/publish

Publier un brouillon d’événement ordinaire précédemment sauvegardé

`publish_event_draft`

Autorisation requise : `events:write`. Publication réelle explicite par le propriétaire canonique des événements annuels. Consulter d’abord get_event_draft_publication_plan, puis fournir idempotencyKey, expectedRevision et son planHash inchangé. Une révision périmée ou une modification de recette/contexte est refusée avant délégation. Autorisations supplémentaires : forms:write pour registration/both, caisses:write pour fundraising/both, messages:write lorsqu’un brouillon de campagne est demandé, content_blocks:read pour un bloc de contenu. Créer une campagne ne l’envoie jamais. Une réservation atomique externe admet au plus une délégation ; répéter une commande réussie inchangée retourne l’acquittement enregistré. Les commandes RUNNING ou UNCERTAIN ne réexécutent jamais automatiquement le propriétaire : lire le brouillon et le projet annuel existant, conserver commandId et vérifier la situation. Aucune nouvelle clé ou révision modifiée ne peut contourner un résultat incertain. Le résultat décrit la publication enregistrée par le propriétaire : PUBLISHED enregistre une ressource publique native, tandis que CREATED place la recette privée dans MATERIALIZED sans page publiée. Aucun de ces statuts ne prouve la présence, le paiement, la livraison d’un message ni le rendu du navigateur. La recette reste un enregistrement détenu par l’API et le projet publié devient visible par la surface existante des événements annuels. Le rattachement d’un formulaire existant demeure indisponible. Cet adaptateur ne verrouille pas transactionnellement les écritures internes. Chaque écriture de l’adaptateur exige w:1 et j:true. Les réservations de journal exigent acknowledged=true et l’identifiant exact inséré ou créé par upsert ; le CAS exige des compteurs acquittés positivement. Un acquittement absent ou incohérent arrête le traitement avant l’effet suivant et renvoie EVENT_WRITE_UNCERTAIN ou l’incertitude propre à l’opération. Conserver l’identité et la clé, vérifier la situation et ne jamais forcer une nouvelle clé ou révision pour répéter les effets.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "UUID d’un brouillon API existant retourné par create_event_draft."
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "planHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "description": "Empreinte inchangée du plan de publication retournée par get_event_draft_publication_plan. Elle qualifie la recette, la devise effective, le fuseau et les instants UTC des séances."
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "planHash"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Réponse développeur pour un événement ordinaire.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "replayed"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EventLifecyclePublication"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_PUBLICATION_INPUT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "AUTORISATION_INSUFFISANTE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_DRAFT_NOT_FOUND / EVENT_REFERENCE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REVISION_CONFLICT / EVENT_PUBLICATION_PLAN_CHANGED / EVENT_PUBLICATION_UNCERTAIN / EVENT_PROJECT_ALREADY_EXISTS / EVENT_DRAFT_STATE_CONFLICT / EVENT_WRITE_UNCERTAIN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 422

```json
{
  "description": "EVENT_DRAFT_NOT_READY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "EVENT_DRAFT_UNAVAILABLE",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## POST /annual-events/{id}/duplicate-draft

Copier un événement annuel géré dans un nouveau brouillon privé

`duplicate_event_to_draft`

Autorisations requises : `events:write` et `events:read`. Copie uniquement la configuration canonique et le calendrier des séances d’un projet annuel ordinaire géré existant à expectedRevision dans un nouveau brouillon privé détenu par l’API. idempotencyKey reste stable dans l’organisation pour cette opération de duplication ; modifier la source, la révision ou le titre avec cette clé renvoie 409. title, facultatif, remplace le titre copié. La destination est volontairement réinitialisée en nouvelle destination non confirmée : lire et examiner la nouvelle recette avant de choisir où la publier. Les prix sont copiés en unités majeures sans conversion uniquement si la devise enregistrée de la source correspond à la devise actuelle prouvée de l’organisation. Le fuseau source est copié comme demande de publication ; le plan effectif doit être examiné à nouveau lors de la publication. Les identifiants et dates des séances sources sont vérifiés à nouveau avec la recette canonique ; une source périmée, manuelle, protégée ou ambiguë est refusée. Un bloc de contenu copié exige content_blocks:read. Seuls les champs de recette sont copiés : aucun identifiant de ressource source, inscription, billet, historique de paiement, campagne envoyée ou état de publication natif. La source n’est jamais modifiée, aucune ressource publique n’est créée et aucun message n’est envoyé. Le brouillon API résultant n’est pas un brouillon local du navigateur admin. Répéter une commande identique terminée renvoie son acquittement enregistré, qui peut précéder des modifications ultérieures de la cible. Un acquittement incertain ne peut être confirmé que par la cible déterministe et l’empreinte immuable de création ; sinon conserver commandId et vérifier la situation, sans choisir automatiquement une nouvelle clé. Il s’agit d’une observation optimiste de la source, pas d’une transaction contre les modifications internes. Chaque écriture de l’adaptateur exige w:1 et j:true. Les réservations de journal exigent acknowledged=true et l’identifiant exact inséré ou créé par upsert ; le CAS exige des compteurs acquittés positivement. Un acquittement absent ou incohérent arrête le traitement avant l’effet suivant et renvoie EVENT_WRITE_UNCERTAIN ou l’incertitude propre à l’opération. Conserver l’identité et la clé, vérifier la situation et ne jamais forcer une nouvelle clé ou révision pour répéter les effets.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "title": {
            "type": "string",
            "minLength": 3,
            "maxLength": 500
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Réponse développeur pour un événement ordinaire.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EventLifecycleResult"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_DUPLICATE_INPUT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_NOT_FOUND / EVENT_REFERENCE_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REVISION_CONFLICT / IDEMPOTENCY_KEY_CONFLICT / INVALID_EVENT_GRAPH / EVENT_DUPLICATION_UNCERTAIN / EVENT_CURRENCY_CHANGED / EVENT_WRITE_UNCERTAIN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:write",
  "x-unisoft-additional-scopes": [
    "events:read"
  ],
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  },
  "x-unisoft-mcp-output-schema": true
}
```

## GET /annual-events/{id}/unpublication-plan

Prévisualiser le masquage d’une page événement en conservant ses enregistrements

`preview_event_unpublication`

Autorisation requise : `events:read`, avec forms:read et caisses:read lorsque des ressources gérées liées existent. Précontrôle en lecture seule d’un projet annuel ordinaire géré publié. Renvoie sa révision native expectedRevision, planHash et les identifiants exacts de séance/formulaire/cagnotte affectés par unpublish_event. Aucun paramètre de requête ni corps accepté. Masquer toutes les séances gérées retire leur page du catalogue public ; les formulaires et cagnottes gérés liés deviennent inactifs. Les enregistrements, inscriptions, billets, produits et paiements sont conservés, sans avis public d’annulation. Ne révoque pas une capacité de paiement existante, n’arrête pas d’abonnement, ne rembourse aucun montant et n’envoie aucun message. Examiner requiredScopes et tous les identifiants affectés ; c’est une observation optimiste, pas un verrou global. Le publicationStatus natif demeure l’historique du propriétaire ; visibility est une observation externe distincte. Les graphes protégés, étrangers, ambigus ou incomplets et les identifiants d’accès restreints à des campagnes sont refusés.

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

### Réponses

#### HTTP 200

```json
{
  "description": "Réponse développeur pour un événement ordinaire.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/EventLifecycleUnpublishPlan"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_EVENT_GRAPH / EVENT_VISIBILITY_STATE_CONFLICT / EVENT_UNPUBLICATION_UNCERTAIN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## POST /annual-events/{id}/unpublish

Masquer une page événement gérée en conservant inscriptions et historique

`unpublish_event`

Autorisation requise : `events:write`, avec forms:write et caisses:write lorsque des ressources gérées liées existent. Examiner d’abord preview_event_unpublication et tous les identifiants affectés. Fournir sa révision native expectedRevision, le planHash inchangé et une idempotencyKey stable. Après réadmission et réservation d’une révision native, rend inactifs uniquement les séances/formulaires/cagnottes gérés admis, enregistre la visibilité externe UNPUBLISHED et invalide les caches publics. Conserve le publicationStatus natif comme historique du propriétaire ; n’invente aucun état natif d’annulation ni avis public Annulé. Projet, séances, formulaires, produits, inscriptions, billets et paiements sont conservés avec leurs identifiants. Aucun remboursement, arrêt d’abonnement, révocation de capacité de paiement, annulation de message ou notification n’est impliqué. Répéter une commande identique terminée renvoie son acquittement enregistré. Les résultats RUNNING/UNCERTAIN ou partiels de stockage/cache restent EVENT_UNPUBLICATION_UNCERTAIN ; conserver commandId/projectId et vérifier la situation, sans forcer une nouvelle clé ou révision. La visibilité publique peut avoir déjà changé pendant l’incertitude. Des autorisations de lecture supplémentaires sont nécessaires pour l’aperçu et les autorisations d’écriture correspondantes pour cette commande. Les écritures internes ne sont pas verrouillées transactionnellement. Les identifiants d’accès restreints à des campagnes sont refusés. Chaque écriture de l’adaptateur exige w:1 et j:true. Les réservations de journal exigent acknowledged=true et l’identifiant exact inséré ou créé par upsert ; le CAS exige des compteurs acquittés positivement. Un acquittement absent ou incohérent arrête le traitement avant l’effet suivant et renvoie EVENT_WRITE_UNCERTAIN ou l’incertitude propre à l’opération. Conserver l’identité et la clé, vérifier la situation et ne jamais forcer une nouvelle clé ou révision pour répéter les effets.

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

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "planHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$",
            "description": "planHash inchangé de preview_event_unpublication, qualifiant les ressources gérées exactes et l’observation de visibilité."
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "planHash"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Réponse développeur pour un événement ordinaire.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "replayed"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EventLifecycleUnpublishResult"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_UNPUBLICATION_INPUT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REVISION_CONFLICT / IDEMPOTENCY_KEY_CONFLICT / EVENT_UNPUBLICATION_PLAN_CHANGED / EVENT_UNPUBLICATION_UNCERTAIN / INVALID_EVENT_GRAPH / EVENT_VISIBILITY_STATE_CONFLICT / EVENT_WRITE_UNCERTAIN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## POST /annual-events/{id}/sessions/{sessionId}/reschedule-plan

Prévisualiser le report d’une séance en conservant ses identités

`preview_event_session_reschedule`

Autorisation requise : `events:read`. Précontrôle en lecture seule : aucune écriture de projet, cache, message ou formulaire. Renvoie la révision du projet natif, planHash, les instants UTC exacts et les identifiants conservés par reschedule_event_session ; c’est une observation optimiste, pas un verrou ni une réservation. Seuls les projets annuels ordinaires gérés et publiés sont pris en charge, avec organisation et références scalaires exactes. localDate et les heures locales utilisent le fuseau IANA existant du projet, jamais un nouveau fuseau supposé. Les identifiants de séance, formulaire, produit, cagnotte et livret ainsi que les inscriptions/billets existants sont conservés ; aucune inscription, aucun paiement, billet ou message n’est créé, supprimé ou réexpédié. Des autorisations de lecture supplémentaires sont requises pour les formulaires et cagnottes liés. Modifier une date parmi plusieurs séances conserve toutes les autres dates et convertit explicitement la recette en dates personnalisées ; modifier l’horaire d’une seule séance d’une série est refusé, car la recette canonique définit des horaires communs. Les produits avec modules de participants (family/children/group) et les graphes de formulaires ambigus ou manuels sont refusés tant que leur publication future ne peut pas conserver toutes les liaisons de réponses. Les dates sont modifiées sur place, sans passer par patch_annual_event qui peut recréer les séances. Les campagnes et communications déjà envoyées restent inchangées : aucune notification des participants n’est impliquée. Les écritures internes ne sont pas verrouillées transactionnellement. Les identifiants d’accès restreints à des campagnes sont refusés.

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

```json
{
  "name": "sessionId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "localDate": {
            "type": "string",
            "format": "date"
          },
          "startTime": {
            "type": "string",
            "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          "endTime": {
            "type": "string",
            "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
          }
        },
        "required": [
          "localDate",
          "startTime",
          "endTime"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Réponse développeur pour un événement ordinaire.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EventLifecycleReschedulePlan"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_RESCHEDULE_INPUT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REVISION_CONFLICT / EVENT_RESCHEDULE_PLAN_CHANGED / EVENT_RESCHEDULE_UNCERTAIN / EVENT_RESCHEDULE_UNSUPPORTED / INVALID_EVENT_GRAPH / IDEMPOTENCY_KEY_CONFLICT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## POST /annual-events/{id}/sessions/{sessionId}/reschedule

Reporter une séance d’événement géré en conservant ses identités

`reschedule_event_session`

Autorisation requise : `events:write`. Appeler d’abord preview_event_session_reschedule et examiner les instants UTC exacts, les identifiants conservés et requiredScopes. Fournir son planHash inchangé, expectedRevision et une idempotencyKey stable avec les mêmes localDate/startTime/endTime. Le plan et les références sont vérifiés à nouveau avant la réservation atomique d’une révision du projet natif. Répéter une commande identique terminée retourne son acquittement enregistré ; les commandes RUNNING ou UNCERTAIN ne doivent jamais être relancées avec une nouvelle clé ou une révision forcée. Les échecs partiels de stockage ou de cache restent EVENT_RESCHEDULE_UNCERTAIN et exigent une vérification par identifiants de projet/séance/commande. Seuls les projets annuels ordinaires gérés et publiés sont pris en charge, avec organisation et références scalaires exactes. localDate et les heures locales utilisent le fuseau IANA existant du projet, jamais un nouveau fuseau supposé. Les identifiants de séance, formulaire, produit, cagnotte et livret ainsi que les inscriptions/billets existants sont conservés ; aucune inscription, aucun paiement, billet ou message n’est créé, supprimé ou réexpédié. Des autorisations d’écriture supplémentaires sont requises pour les formulaires et cagnottes liés. Modifier une date parmi plusieurs séances conserve toutes les autres dates et convertit explicitement la recette en dates personnalisées ; modifier l’horaire d’une seule séance d’une série est refusé, car la recette canonique définit des horaires communs. Les produits avec modules de participants (family/children/group) et les graphes de formulaires ambigus ou manuels sont refusés tant que leur publication future ne peut pas conserver toutes les liaisons de réponses. Les dates sont modifiées sur place, sans passer par patch_annual_event qui peut recréer les séances. Les campagnes et communications déjà envoyées restent inchangées : aucune notification des participants n’est impliquée. Les écritures internes ne sont pas verrouillées transactionnellement. Les identifiants d’accès restreints à des campagnes sont refusés. Chaque écriture de l’adaptateur exige w:1 et j:true. Les réservations de journal exigent acknowledged=true et l’identifiant exact inséré ou créé par upsert ; le CAS exige des compteurs acquittés positivement. Un acquittement absent ou incohérent arrête le traitement avant l’effet suivant et renvoie EVENT_WRITE_UNCERTAIN ou l’incertitude propre à l’opération. Conserver l’identité et la clé, vérifier la situation et ne jamais forcer une nouvelle clé ou révision pour répéter les effets.

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

```json
{
  "name": "sessionId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{3,128}$"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "localDate": {
            "type": "string",
            "format": "date"
          },
          "startTime": {
            "type": "string",
            "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          "endTime": {
            "type": "string",
            "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          "idempotencyKey": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "planHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          }
        },
        "required": [
          "localDate",
          "startTime",
          "endTime",
          "idempotencyKey",
          "expectedRevision",
          "planHash"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Réponse développeur pour un événement ordinaire.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EventLifecycleRescheduleResult"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_RESCHEDULE_INPUT",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE / CAMPAIGN_RESTRICTED_KEY",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "EVENT_NOT_FOUND",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REVISION_CONFLICT / EVENT_RESCHEDULE_PLAN_CHANGED / EVENT_RESCHEDULE_UNCERTAIN / EVENT_RESCHEDULE_UNSUPPORTED / INVALID_EVENT_GRAPH / IDEMPOTENCY_KEY_CONFLICT / EVENT_WRITE_UNCERTAIN",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "required": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## Schémas

```json
{
  "components": {
    "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"
          }
        }
      },
      "UnisoftRequest_133a453e99d95d23090e": {
        "type": "object",
        "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": {
            "type": "object",
            "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"
            ],
            "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."
          },
          "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": {
            "not": {}
          },
          "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": {
              "type": "object",
              "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"
              ],
              "additionalProperties": false
            }
          },
          "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": {
              "type": "object",
              "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",
                  "properties": {
                    "questionId": {
                      "type": "string"
                    },
                    "value": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "questionId",
                    "value"
                  ],
                  "additionalProperties": false,
                  "nullable": true
                }
              },
              "required": [
                "label",
                "type"
              ],
              "additionalProperties": false
            }
          },
          "requirementsEnabled": {
            "type": "boolean"
          },
          "requirements": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "label": {
                  "type": "string",
                  "maxLength": 500
                },
                "required": {
                  "type": "boolean"
                }
              },
              "required": [
                "label"
              ],
              "additionalProperties": false
            }
          },
          "manualValidation": {
            "type": "boolean"
          },
          "confirmationText": {
            "type": "string",
            "maxLength": 5000
          },
          "reminders": {
            "type": "object",
            "properties": {
              "confirmation": {
                "type": "boolean"
              },
              "weekBefore": {
                "type": "boolean"
              },
              "dayBefore": {
                "type": "boolean"
              }
            },
            "additionalProperties": false
          },
          "page": {
            "type": "object",
            "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",
                "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`."
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          "poster": {
            "type": "object",
            "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
              }
            },
            "additionalProperties": false,
            "description": "Une affiche n’existe que lorsque `source=upload` et que `image` référence une véritable image."
          },
          "campaignEnabled": {
            "type": "boolean",
            "description": "Lorsque true, créer ou mettre à jour un brouillon de campagne ; il n’est jamais envoyé automatiquement."
          },
          "campaign": {
            "type": "object",
            "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."
              }
            },
            "additionalProperties": false
          },
          "posterAnalysis": {
            "type": "object",
            "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"
              }
            },
            "additionalProperties": false,
            "nullable": true,
            "description": "Métadonnées d’audit conservées lorsque le brouillon a été préparé à partir d’une affiche."
          },
          "draftStatus": {
            "type": "string",
            "enum": [
              "EDITING",
              "READY"
            ]
          },
          "validatedAt": {
            "type": "string",
            "nullable": true
          },
          "cursorStepId": {
            "type": "string"
          },
          "idempotencyKey": {
            "type": "string",
            "maxLength": 200
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "timeZone": {
            "type": "string"
          }
        },
        "required": [
          "title",
          "destination",
          "mode",
          "idempotencyKey"
        ],
        "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."
      },
      "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"
        ]
      },
      "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"
          }
        }
      },
      "UnisoftRequest_95690b6a2d37403c8838": {
        "type": "object",
        "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": {
            "type": "object",
            "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"
            ],
            "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."
          },
          "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": {
            "not": {}
          },
          "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": {
              "type": "object",
              "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"
              ],
              "additionalProperties": false
            }
          },
          "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": {
              "type": "object",
              "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",
                  "properties": {
                    "questionId": {
                      "type": "string"
                    },
                    "value": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "questionId",
                    "value"
                  ],
                  "additionalProperties": false,
                  "nullable": true
                }
              },
              "required": [
                "label",
                "type"
              ],
              "additionalProperties": false
            }
          },
          "requirementsEnabled": {
            "type": "boolean"
          },
          "requirements": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "label": {
                  "type": "string",
                  "maxLength": 500
                },
                "required": {
                  "type": "boolean"
                }
              },
              "required": [
                "label"
              ],
              "additionalProperties": false
            }
          },
          "manualValidation": {
            "type": "boolean"
          },
          "confirmationText": {
            "type": "string",
            "maxLength": 5000
          },
          "reminders": {
            "type": "object",
            "properties": {
              "confirmation": {
                "type": "boolean"
              },
              "weekBefore": {
                "type": "boolean"
              },
              "dayBefore": {
                "type": "boolean"
              }
            },
            "additionalProperties": false
          },
          "page": {
            "type": "object",
            "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",
                "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`."
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          "poster": {
            "type": "object",
            "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
              }
            },
            "additionalProperties": false,
            "description": "Une affiche n’existe que lorsque `source=upload` et que `image` référence une véritable image."
          },
          "campaignEnabled": {
            "type": "boolean",
            "description": "Lorsque true, créer ou mettre à jour un brouillon de campagne ; il n’est jamais envoyé automatiquement."
          },
          "campaign": {
            "type": "object",
            "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."
              }
            },
            "additionalProperties": false
          },
          "posterAnalysis": {
            "type": "object",
            "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"
              }
            },
            "additionalProperties": false,
            "nullable": true,
            "description": "Métadonnées d’audit conservées lorsque le brouillon a été préparé à partir d’une affiche."
          },
          "draftStatus": {
            "type": "string",
            "enum": [
              "EDITING",
              "READY"
            ]
          },
          "validatedAt": {
            "type": "string",
            "nullable": true
          },
          "cursorStepId": {
            "type": "string"
          }
        },
        "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."
      },
      "UnisoftRequest_0667b8aac019eb4d0f07": {
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "action": {
                "type": "string",
                "enum": [
                  "ADD_DATES"
                ]
              },
              "dates": {
                "type": "array",
                "minItems": 1,
                "maxItems": 200,
                "uniqueItems": true,
                "items": {
                  "type": "string",
                  "format": "date"
                }
              }
            },
            "required": [
              "action",
              "dates"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "action": {
                "type": "string",
                "enum": [
                  "REMOVE_SESSIONS"
                ]
              },
              "selection": {
                "oneOf": [
                  {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "EXPLICIT"
                        ]
                      },
                      "sessionIds": {
                        "type": "array",
                        "minItems": 1,
                        "maxItems": 200,
                        "uniqueItems": true,
                        "items": {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9_-]{3,128}$"
                        }
                      }
                    },
                    "required": [
                      "kind",
                      "sessionIds"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "FROM_SESSION"
                        ]
                      },
                      "sessionId": {
                        "type": "string",
                        "pattern": "^[A-Za-z0-9_-]{3,128}$"
                      }
                    },
                    "required": [
                      "kind",
                      "sessionId"
                    ],
                    "additionalProperties": false
                  }
                ]
              }
            },
            "required": [
              "action",
              "selection"
            ],
            "additionalProperties": false
          },
          {
            "$ref": "#/components/schemas/UnisoftRequest_9724e4bec01b841b6283"
          }
        ]
      },
      "UnisoftRequest_9724e4bec01b841b6283": {
        "type": "object",
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "SET_RECURRENCE"
            ]
          },
          "selection": {
            "oneOf": [
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "ALL"
                    ]
                  }
                },
                "required": [
                  "kind"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "FROM_SESSION"
                    ]
                  },
                  "sessionId": {
                    "type": "string",
                    "pattern": "^[A-Za-z0-9_-]{3,128}$"
                  }
                },
                "required": [
                  "kind",
                  "sessionId"
                ],
                "additionalProperties": false
              }
            ]
          },
          "schedule": {
            "oneOf": [
              {
                "type": "object",
                "properties": {
                  "cadence": {
                    "type": "string",
                    "enum": [
                      "once"
                    ]
                  },
                  "date": {
                    "type": "string",
                    "format": "date"
                  }
                },
                "required": [
                  "cadence",
                  "date"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "cadence": {
                    "type": "string",
                    "enum": [
                      "weekly",
                      "monthly"
                    ]
                  },
                  "date": {
                    "type": "string",
                    "format": "date"
                  },
                  "recurrenceCount": {
                    "type": "integer",
                    "minimum": 2,
                    "maximum": 200
                  },
                  "excludedDates": {
                    "type": "array",
                    "minItems": 0,
                    "maxItems": 200,
                    "uniqueItems": true,
                    "items": {
                      "type": "string",
                      "format": "date"
                    }
                  }
                },
                "required": [
                  "cadence",
                  "date",
                  "recurrenceCount"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "cadence": {
                    "type": "string",
                    "enum": [
                      "custom"
                    ]
                  },
                  "customDates": {
                    "type": "array",
                    "minItems": 2,
                    "maxItems": 200,
                    "uniqueItems": true,
                    "items": {
                      "type": "string",
                      "format": "date"
                    }
                  }
                },
                "required": [
                  "cadence",
                  "customDates"
                ],
                "additionalProperties": false
              }
            ]
          }
        },
        "required": [
          "action",
          "selection",
          "schedule"
        ],
        "additionalProperties": false
      },
      "EventSeriesPlan": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "projectId",
          "expectedRevision",
          "planHash",
          "effectiveTimeZone",
          "currency",
          "publicBaseUrl",
          "requiredReadScopes",
          "requiredWriteScopes",
          "currentSessions",
          "nextSessions",
          "retiredSessionIds",
          "addedLogicalKeys",
          "selectedSessionIds",
          "finalCadence",
          "publicTargetMayChange",
          "expectedPublicTargetId",
          "refreshScope",
          "manualOverridePreservation",
          "historyImpact",
          "campaignDelivery"
        ],
        "properties": {
          "projectId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "planHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "effectiveTimeZone": {
            "type": "string"
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$"
          },
          "publicBaseUrl": {
            "type": "string",
            "format": "uri"
          },
          "requiredReadScopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "requiredWriteScopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "currentSessions": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "sessionId",
                "logicalKey",
                "startAt",
                "endAt",
                "active"
              ],
              "properties": {
                "sessionId": {
                  "type": "string",
                  "pattern": "^[A-Za-z0-9_-]{3,128}$",
                  "nullable": true
                },
                "logicalKey": {
                  "type": "string"
                },
                "startAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "endAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "active": {
                  "type": "boolean"
                }
              }
            }
          },
          "nextSessions": {
            "type": "array",
            "minItems": 1,
            "maxItems": 200,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "sessionId",
                "logicalKey",
                "startAt",
                "endAt",
                "active"
              ],
              "properties": {
                "sessionId": {
                  "type": "string",
                  "pattern": "^[A-Za-z0-9_-]{3,128}$",
                  "nullable": true
                },
                "logicalKey": {
                  "type": "string"
                },
                "startAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "endAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "active": {
                  "type": "boolean"
                }
              }
            }
          },
          "retiredSessionIds": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{3,128}$"
            },
            "uniqueItems": true
          },
          "addedLogicalKeys": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string"
            }
          },
          "selectedSessionIds": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{3,128}$"
            },
            "uniqueItems": true
          },
          "finalCadence": {
            "type": "string",
            "enum": [
              "once",
              "weekly",
              "monthly",
              "custom"
            ]
          },
          "publicTargetMayChange": {
            "type": "boolean"
          },
          "expectedPublicTargetId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$",
            "nullable": true
          },
          "refreshScope": {
            "type": "string",
            "enum": [
              "ALL_REMAINING_MANAGED_RESOURCES"
            ]
          },
          "manualOverridePreservation": {
            "type": "string",
            "enum": [
              "NOT_GUARANTEED"
            ]
          },
          "historyImpact": {
            "type": "string",
            "enum": [
              "RETIRED_PE_FORMS_FUNDS_INACTIVE_OTHER_ROWS_RETAINED"
            ]
          },
          "campaignDelivery": {
            "type": "string",
            "enum": [
              "NOT_SENT"
            ]
          }
        }
      },
      "EventSeriesCommandResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "eventId",
              "projectId",
              "publicationStatus",
              "revision",
              "publishedAt",
              "publicUrl",
              "resources",
              "operationalState"
            ],
            "properties": {
              "eventId": {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{3,128}$"
              },
              "projectId": {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{3,128}$"
              },
              "publicationStatus": {
                "type": "string",
                "enum": [
                  "PUBLISHED",
                  "CREATED"
                ]
              },
              "revision": {
                "type": "integer",
                "minimum": 1
              },
              "publishedAt": {
                "type": "string",
                "format": "date-time",
                "nullable": true
              },
              "publicUrl": {
                "type": "string",
                "format": "uri",
                "nullable": true
              },
              "resources": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "groupId",
                  "sessionIds",
                  "formIds",
                  "fundraiserIds",
                  "campaignIds"
                ],
                "properties": {
                  "groupId": {
                    "type": "string",
                    "pattern": "^[A-Za-z0-9_-]{3,128}$",
                    "nullable": true
                  },
                  "sessionIds": {
                    "type": "array",
                    "maxItems": 200,
                    "items": {
                      "type": "string",
                      "pattern": "^[A-Za-z0-9_-]{3,128}$"
                    }
                  },
                  "formIds": {
                    "type": "array",
                    "maxItems": 200,
                    "items": {
                      "type": "string",
                      "pattern": "^[A-Za-z0-9_-]{3,128}$"
                    }
                  },
                  "fundraiserIds": {
                    "type": "array",
                    "maxItems": 200,
                    "items": {
                      "type": "string",
                      "pattern": "^[A-Za-z0-9_-]{3,128}$"
                    }
                  },
                  "campaignIds": {
                    "type": "array",
                    "maxItems": 200,
                    "items": {
                      "type": "string",
                      "pattern": "^[A-Za-z0-9_-]{3,128}$"
                    }
                  }
                }
              },
              "operationalState": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "registration"
                ],
                "properties": {
                  "registration": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "configured",
                      "open",
                      "submissionCount"
                    ],
                    "properties": {
                      "configured": {
                        "type": "boolean"
                      },
                      "open": {
                        "type": "boolean"
                      },
                      "submissionCount": {
                        "type": "integer",
                        "minimum": 0
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "EventPublicLinksResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "projectId",
              "projectRevision",
              "publicationStatus",
              "observedAt",
              "site",
              "page",
              "links",
              "publicRenderingVerified",
              "stockChecked",
              "paymentReadiness"
            ],
            "properties": {
              "projectId": {
                "type": "string",
                "pattern": "^[A-Za-z0-9_-]{3,128}$"
              },
              "projectRevision": {
                "type": "integer",
                "minimum": 1
              },
              "publicationStatus": {
                "type": "string",
                "enum": [
                  "PUBLISHED",
                  "CREATED"
                ]
              },
              "observedAt": {
                "type": "string",
                "format": "date-time"
              },
              "site": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "virtualId",
                  "language",
                  "publicBaseUrl"
                ],
                "properties": {
                  "virtualId": {
                    "type": "string",
                    "format": "uuid",
                    "nullable": true
                  },
                  "language": {
                    "type": "string",
                    "enum": [
                      "fr",
                      "en",
                      "he",
                      "it",
                      "ru",
                      "pt",
                      "de",
                      "es",
                      "gr",
                      "ro"
                    ]
                  },
                  "publicBaseUrl": {
                    "type": "string",
                    "format": "uri",
                    "maxLength": 2500
                  }
                }
              },
              "page": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "targetId",
                  "publicWindow",
                  "url",
                  "embed"
                ],
                "properties": {
                  "targetId": {
                    "type": "string",
                    "pattern": "^[A-Za-z0-9_-]{3,128}$",
                    "nullable": true
                  },
                  "publicWindow": {
                    "type": "string",
                    "enum": [
                      "OBSERVED_OPEN",
                      "WITHHELD"
                    ]
                  },
                  "url": {
                    "type": "string",
                    "format": "uri",
                    "maxLength": 2500,
                    "nullable": true
                  },
                  "embed": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "url",
                      "integration",
                      "html",
                      "autoResize",
                      "hostBridgeIncluded"
                    ],
                    "properties": {
                      "url": {
                        "type": "string",
                        "format": "uri",
                        "maxLength": 2500
                      },
                      "integration": {
                        "type": "string",
                        "enum": [
                          "NATIVE_IFRAME"
                        ]
                      },
                      "html": {
                        "type": "string",
                        "maxLength": 4096
                      },
                      "autoResize": {
                        "type": "boolean",
                        "enum": [
                          false
                        ]
                      },
                      "hostBridgeIncluded": {
                        "type": "boolean",
                        "enum": [
                          false
                        ]
                      }
                    },
                    "nullable": true
                  }
                }
              },
              "links": {
                "type": "array",
                "maxItems": 400,
                "items": {
                  "$ref": "#/components/schemas/EventPublicLink"
                }
              },
              "publicRenderingVerified": {
                "type": "boolean",
                "enum": [
                  false
                ]
              },
              "stockChecked": {
                "type": "boolean",
                "enum": [
                  false
                ]
              },
              "paymentReadiness": {
                "type": "string",
                "enum": [
                  "NOT_EVALUATED"
                ]
              }
            }
          }
        }
      },
      "EventPublicLink": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "kind",
          "targetId",
          "sessionId",
          "publicWindow",
          "url",
          "embed"
        ],
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "REGISTRATION",
              "FUNDRAISER"
            ]
          },
          "targetId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$"
          },
          "sessionId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{3,128}$",
            "nullable": true
          },
          "publicWindow": {
            "type": "string",
            "enum": [
              "OBSERVED_OPEN",
              "WITHHELD"
            ]
          },
          "url": {
            "type": "string",
            "format": "uri",
            "maxLength": 2500,
            "nullable": true
          },
          "embed": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "url",
              "integration",
              "html",
              "autoResize",
              "hostBridgeIncluded"
            ],
            "properties": {
              "url": {
                "type": "string",
                "format": "uri",
                "maxLength": 2500
              },
              "integration": {
                "type": "string",
                "enum": [
                  "NATIVE_IFRAME"
                ]
              },
              "html": {
                "type": "string",
                "maxLength": 4096
              },
              "autoResize": {
                "type": "boolean",
                "enum": [
                  false
                ]
              },
              "hostBridgeIncluded": {
                "type": "boolean",
                "enum": [
                  false
                ]
              }
            },
            "nullable": true
          }
        }
      },
      "EventLifecycleHistoryResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "nextCursor",
          "coverage"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/EventLifecycleHistoryEntry"
            }
          },
          "nextCursor": {
            "type": "string",
            "nullable": true
          },
          "coverage": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "source",
              "nativeTransitions",
              "privateDraftCreation",
              "currentResource",
              "complete"
            ],
            "properties": {
              "source": {
                "type": "string",
                "enum": [
                  "EXTERNAL_EVENT_COMMAND_JOURNAL"
                ]
              },
              "nativeTransitions": {
                "type": "string",
                "enum": [
                  "NOT_CAPTURED"
                ]
              },
              "privateDraftCreation": {
                "type": "string",
                "enum": [
                  "NOT_A_COMMAND_IN_THIS_JOURNAL"
                ]
              },
              "currentResource": {
                "type": "string",
                "enum": [
                  "NOT_EVALUATED"
                ]
              },
              "complete": {
                "type": "boolean",
                "enum": [
                  false
                ]
              }
            }
          }
        }
      },
      "EventLifecycleHistoryEntry": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "commandId",
          "operation",
          "state",
          "createdAt",
          "finishedAt",
          "projectId",
          "draftId",
          "sourceProjectId",
          "sessionId",
          "sourceRevision",
          "recipeRevision",
          "nativeRevision",
          "recordedOutcome"
        ],
        "properties": {
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "operation": {
            "type": "string",
            "enum": [
              "PUBLISH",
              "REPLACE_RECIPE",
              "DUPLICATE_DRAFT",
              "RESCHEDULE",
              "UNPUBLISH",
              "LEGACY_POST",
              "LEGACY_PATCH",
              "SERIES_UPDATE"
            ]
          },
          "state": {
            "type": "string",
            "enum": [
              "RUNNING",
              "SUCCEEDED",
              "REFUSED",
              "UNCERTAIN"
            ]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "finishedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "projectId": {
            "type": "string",
            "nullable": true
          },
          "draftId": {
            "type": "string",
            "nullable": true
          },
          "sourceProjectId": {
            "type": "string",
            "nullable": true
          },
          "sessionId": {
            "type": "string",
            "nullable": true
          },
          "sourceRevision": {
            "type": "integer",
            "minimum": 1,
            "nullable": true
          },
          "recipeRevision": {
            "type": "integer",
            "minimum": 1,
            "nullable": true
          },
          "nativeRevision": {
            "type": "integer",
            "minimum": 1,
            "nullable": true
          },
          "recordedOutcome": {
            "type": "string",
            "enum": [
              "PUBLISHED",
              "CREATED",
              "UNPUBLISHED",
              null
            ],
            "nullable": true
          }
        }
      },
      "UnisoftRequest_b6493128eea60f41ebb4": {
        "type": "object",
        "properties": {
          "templateId": {
            "type": "string",
            "maxLength": 100,
            "description": "Identifiant de format suggéré, ou `custom`."
          },
          "destination": {
            "type": "object",
            "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"
            ],
            "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."
          },
          "title": {
            "type": "string",
            "minLength": 3,
            "maxLength": 500
          },
          "sourceLanguage": {
            "type": "string",
            "maxLength": 10,
            "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."
          },
          "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": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          "endTime": {
            "type": "string",
            "pattern": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          "locationMode": {
            "type": "string",
            "enum": [
              "onsite",
              "online"
            ]
          },
          "locationName": {
            "type": "string",
            "maxLength": 500
          },
          "address": {
            "type": "string",
            "maxLength": 1000
          },
          "onlineUrl": {
            "type": "string",
            "maxLength": 2000,
            "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,
            "maximum": 90071992547409,
            "multipleOf": 0.01
          },
          "prices": {
            "type": "object",
            "maxProperties": 30,
            "additionalProperties": {
              "type": "number",
              "minimum": 0,
              "maximum": 90071992547409,
              "multipleOf": 0.01
            },
            "description": "Prix en unités monétaires majeures, avec uniquement des codes de devise de trois lettres minuscules et au plus 30 entrées. Aucun champ de métadonnées arbitraire n’est accepté."
          },
          "tariffs": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 100
                },
                "label": {
                  "type": "string",
                  "maxLength": 300
                },
                "price": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 90071992547409,
                  "multipleOf": 0.01
                },
                "prices": {
                  "type": "object",
                  "maxProperties": 30,
                  "additionalProperties": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 90071992547409,
                    "multipleOf": 0.01
                  },
                  "description": "Prix en unités monétaires majeures, avec uniquement des codes de devise de trois lettres minuscules et au plus 30 entrées. Aucun champ de métadonnées arbitraire n’est accepté."
                },
                "stock": {
                  "type": "integer",
                  "minimum": 0,
                  "nullable": true
                }
              },
              "required": [
                "label",
                "price"
              ],
              "additionalProperties": false
            }
          },
          "target": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409,
            "multipleOf": 0.01
          },
          "partialPayments": {
            "type": "boolean"
          },
          "depositAmount": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409,
            "multipleOf": 0.01
          },
          "contributionAmounts": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 90071992547409,
              "multipleOf": 0.01
            }
          },
          "fields": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "string",
              "enum": [
                "firstName",
                "lastName",
                "email",
                "phone",
                "address",
                "birthDate"
              ]
            }
          },
          "children": {
            "type": "boolean"
          },
          "questions": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "object",
              "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",
                  "properties": {
                    "questionId": {
                      "type": "string",
                      "maxLength": 100
                    },
                    "value": {
                      "type": "string",
                      "maxLength": 300
                    }
                  },
                  "required": [
                    "questionId",
                    "value"
                  ],
                  "additionalProperties": false,
                  "nullable": true
                }
              },
              "required": [
                "label",
                "type"
              ],
              "additionalProperties": false
            }
          },
          "requirementsEnabled": {
            "type": "boolean"
          },
          "requirements": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 100
                },
                "label": {
                  "type": "string",
                  "maxLength": 500
                },
                "required": {
                  "type": "boolean"
                }
              },
              "required": [
                "label"
              ],
              "additionalProperties": false
            }
          },
          "manualValidation": {
            "type": "boolean"
          },
          "confirmationText": {
            "type": "string",
            "maxLength": 5000
          },
          "reminders": {
            "type": "object",
            "properties": {
              "confirmation": {
                "type": "boolean"
              },
              "weekBefore": {
                "type": "boolean"
              },
              "dayBefore": {
                "type": "boolean"
              }
            },
            "additionalProperties": false
          },
          "page": {
            "type": "object",
            "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",
                "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`."
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          "poster": {
            "type": "object",
            "properties": {
              "source": {
                "type": "string",
                "enum": [
                  "none",
                  "upload"
                ]
              },
              "image": {
                "type": "string",
                "maxLength": 200,
                "nullable": true,
                "description": "Nom de fichier JPEG, PNG ou WebP déjà hébergé et appartenant à l’organisation. Les URL distantes, chemins et SVG sont refusés ; enregistrer un brouillon ne télécharge jamais d’affiche."
              },
              "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
              }
            },
            "additionalProperties": false,
            "description": "Une affiche n’existe que lorsque `source=upload` et que `image` référence une véritable image."
          },
          "campaignEnabled": {
            "type": "boolean",
            "description": "Lorsque true, créer ou mettre à jour un brouillon de campagne ; il n’est jamais envoyé automatiquement."
          },
          "campaign": {
            "type": "object",
            "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",
                "maxLength": 100,
                "nullable": true,
                "description": "Date et heure ISO utilisées lorsque la campagne sera finalement envoyée."
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "title",
          "destination",
          "mode"
        ],
        "additionalProperties": false,
        "description": "Recette canonique d’événement ordinaire stockée en privé par cette API. Les valeurs facultatives absentes restent absentes. Il ne s’agit ni d’un événement public ni d’un brouillon local du navigateur admin. Les prix, objectifs, acomptes et montants de contribution sont en unités monétaires majeures, pas mineures ; cette opération ne réalise aucun encaissement ni conversion de devise."
      },
      "EventLifecycleResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EventLifecycleDraft"
          }
        }
      },
      "EventLifecycleDraft": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "kind",
          "state",
          "revision",
          "recipe",
          "requestedTimeZone",
          "validation",
          "createdAt",
          "updatedAt",
          "publication",
          "publicationCommandId"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "kind": {
            "type": "string",
            "enum": [
              "ORDINARY_EVENT_DRAFT"
            ]
          },
          "state": {
            "type": "string",
            "enum": [
              "DRAFT",
              "PUBLISHING",
              "PUBLISHED",
              "MATERIALIZED",
              "PUBLICATION_UNCERTAIN"
            ]
          },
          "revision": {
            "type": "integer",
            "minimum": 1
          },
          "recipe": {
            "$ref": "#/components/schemas/EventLifecycleRecipe"
          },
          "requestedTimeZone": {
            "type": "string",
            "nullable": true
          },
          "validation": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "scope",
              "status",
              "issues"
            ],
            "properties": {
              "scope": {
                "type": "string",
                "enum": [
                  "RECIPE_ONLY"
                ]
              },
              "status": {
                "type": "string",
                "enum": [
                  "VALID",
                  "INCOMPLETE"
                ]
              },
              "issues": {
                "type": "array",
                "maxItems": 1,
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "publication": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "draftId",
              "projectId",
              "commandId",
              "draftRevision",
              "projectRevision",
              "publicationStatus",
              "effectiveTimeZone",
              "currency",
              "publicUrl",
              "publishedAt"
            ],
            "properties": {
              "draftId": {
                "type": "string",
                "format": "uuid"
              },
              "projectId": {
                "type": "string",
                "format": "uuid"
              },
              "commandId": {
                "type": "string",
                "format": "uuid"
              },
              "draftRevision": {
                "type": "integer",
                "minimum": 2
              },
              "projectRevision": {
                "type": "integer",
                "minimum": 1
              },
              "publicationStatus": {
                "type": "string",
                "enum": [
                  "PUBLISHED",
                  "CREATED"
                ]
              },
              "effectiveTimeZone": {
                "type": "string"
              },
              "currency": {
                "type": "string",
                "pattern": "^[a-z]{3}$"
              },
              "publicUrl": {
                "type": "string",
                "nullable": true
              },
              "publishedAt": {
                "type": "string",
                "format": "date-time",
                "nullable": true
              }
            },
            "nullable": true
          },
          "publicationCommandId": {
            "type": "string",
            "format": "uuid",
            "nullable": true,
            "description": "Identifiant opaque de corrélation de la commande externe de publication. Ce n’est ni un identifiant d’authentification prestataire ni un jeton d’accès."
          }
        }
      },
      "EventLifecycleRecipe": {
        "type": "object",
        "additionalProperties": false,
        "description": "Recette canonique d’événement ordinaire stockée en privé par cette API. Les valeurs facultatives absentes restent absentes. Il ne s’agit ni d’un événement public ni d’un brouillon local du navigateur admin. Les prix, objectifs, acomptes et montants de contribution sont en unités monétaires majeures, pas mineures ; cette opération ne réalise aucun encaissement ni conversion de devise.",
        "properties": {
          "templateId": {
            "type": "string",
            "description": "Identifiant de format suggéré, ou `custom`.",
            "maxLength": 100
          },
          "destination": {
            "$ref": "#/components/schemas/EventLifecycleDestination"
          },
          "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.",
            "maxLength": 10
          },
          "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": "^(?:[01][0-9]|2[0-3]):[0-5][0-9]$"
          },
          "endTime": {
            "type": "string",
            "pattern": "^(?:[01][0-9]|2[0-3]):[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",
            "maxLength": 2000
          },
          "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,
            "maximum": 90071992547409,
            "multipleOf": 0.01
          },
          "prices": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "minimum": 0,
              "maximum": 90071992547409,
              "multipleOf": 0.01
            },
            "description": "Prix en unités monétaires majeures, avec uniquement des codes de devise de trois lettres minuscules et au plus 30 entrées. Aucun champ de métadonnées arbitraire n’est accepté.",
            "maxProperties": 30,
            "x-unisoft-map-key-pattern": "^[a-z]{3}$"
          },
          "tariffs": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/EventLifecycleTariff"
            }
          },
          "target": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409,
            "multipleOf": 0.01
          },
          "partialPayments": {
            "type": "boolean"
          },
          "depositAmount": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409,
            "multipleOf": 0.01
          },
          "contributionAmounts": {
            "type": "array",
            "maxItems": 20,
            "items": {
              "type": "number",
              "minimum": 0.01,
              "maximum": 90071992547409,
              "multipleOf": 0.01
            }
          },
          "fields": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "firstName",
                "lastName",
                "email",
                "phone",
                "address",
                "birthDate"
              ]
            },
            "maxItems": 100
          },
          "children": {
            "type": "boolean"
          },
          "questions": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/EventLifecycleQuestion"
            }
          },
          "requirementsEnabled": {
            "type": "boolean"
          },
          "requirements": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "$ref": "#/components/schemas/EventLifecycleRequirement"
            }
          },
          "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,
                "maxLength": 200,
                "description": "Nom de fichier JPEG, PNG ou WebP déjà hébergé et appartenant à l’organisation. Les URL distantes, chemins et SVG sont refusés ; enregistrer un brouillon ne télécharge jamais d’affiche."
              },
              "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.",
                "maxLength": 100
              }
            }
          }
        },
        "required": [
          "title",
          "destination",
          "mode"
        ]
      },
      "EventLifecycleDestination": {
        "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"
        ]
      },
      "EventLifecycleTariff": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 100
          },
          "label": {
            "type": "string",
            "maxLength": 300
          },
          "price": {
            "type": "number",
            "minimum": 0,
            "maximum": 90071992547409,
            "multipleOf": 0.01
          },
          "prices": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "minimum": 0,
              "maximum": 90071992547409,
              "multipleOf": 0.01
            },
            "description": "Prix en unités monétaires majeures, avec uniquement des codes de devise de trois lettres minuscules et au plus 30 entrées. Aucun champ de métadonnées arbitraire n’est accepté.",
            "maxProperties": 30,
            "x-unisoft-map-key-pattern": "^[a-z]{3}$"
          },
          "stock": {
            "type": "integer",
            "minimum": 0,
            "nullable": true
          }
        },
        "required": [
          "label",
          "price"
        ]
      },
      "EventLifecycleQuestion": {
        "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",
                "maxLength": 100
              },
              "value": {
                "type": "string",
                "maxLength": 300
              }
            },
            "required": [
              "questionId",
              "value"
            ]
          }
        },
        "required": [
          "label",
          "type"
        ]
      },
      "EventLifecycleRequirement": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 100
          },
          "label": {
            "type": "string",
            "maxLength": 500
          },
          "required": {
            "type": "boolean"
          }
        },
        "required": [
          "label"
        ]
      },
      "EventLifecyclePublicationPlan": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "draftId",
          "expectedRevision",
          "planHash",
          "currency",
          "effectiveTimeZone",
          "publicBaseUrl",
          "requiredScopes",
          "sessions"
        ],
        "properties": {
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "planHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$"
          },
          "effectiveTimeZone": {
            "type": "string"
          },
          "publicBaseUrl": {
            "type": "string",
            "format": "uri"
          },
          "requiredScopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "sessions": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "logicalKey",
                "startAt",
                "endAt"
              ],
              "properties": {
                "logicalKey": {
                  "type": "string"
                },
                "startAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "endAt": {
                  "type": "string",
                  "format": "date-time"
                }
              }
            }
          }
        }
      },
      "EventLifecyclePublication": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "draftId",
          "projectId",
          "commandId",
          "draftRevision",
          "projectRevision",
          "publicationStatus",
          "effectiveTimeZone",
          "currency",
          "publicUrl",
          "publishedAt"
        ],
        "properties": {
          "draftId": {
            "type": "string",
            "format": "uuid"
          },
          "projectId": {
            "type": "string",
            "format": "uuid"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "draftRevision": {
            "type": "integer",
            "minimum": 2
          },
          "projectRevision": {
            "type": "integer",
            "minimum": 1
          },
          "publicationStatus": {
            "type": "string",
            "enum": [
              "PUBLISHED",
              "CREATED"
            ]
          },
          "effectiveTimeZone": {
            "type": "string"
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$"
          },
          "publicUrl": {
            "type": "string",
            "nullable": true
          },
          "publishedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        }
      },
      "EventLifecycleUnpublishPlan": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "projectId",
          "expectedRevision",
          "planHash",
          "publicResourceId",
          "requiredScopes",
          "sessionIds",
          "formIds",
          "fundraiserIds",
          "historyPreserved"
        ],
        "properties": {
          "projectId": {
            "type": "string"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "planHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "publicResourceId": {
            "type": "string"
          },
          "requiredScopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "historyPreserved": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "sessionIds": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string"
            }
          },
          "formIds": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string"
            }
          },
          "fundraiserIds": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string"
            }
          }
        }
      },
      "EventLifecycleUnpublishResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "projectId",
          "commandId",
          "revision",
          "visibility",
          "sessionIds",
          "formIds",
          "fundraiserIds",
          "historyPreserved"
        ],
        "properties": {
          "projectId": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "revision": {
            "type": "integer",
            "minimum": 2
          },
          "visibility": {
            "type": "string",
            "enum": [
              "UNPUBLISHED"
            ]
          },
          "historyPreserved": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "sessionIds": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string"
            }
          },
          "formIds": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string"
            }
          },
          "fundraiserIds": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "string"
            }
          }
        }
      },
      "EventLifecycleReschedulePlan": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "projectId",
          "sessionId",
          "expectedRevision",
          "planHash",
          "effectiveTimeZone",
          "previous",
          "next",
          "requiredScopes",
          "preserved",
          "seriesBecomesCustom",
          "campaignsUnchanged"
        ],
        "properties": {
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "expectedRevision": {
            "type": "integer",
            "minimum": 1
          },
          "planHash": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "effectiveTimeZone": {
            "type": "string"
          },
          "previous": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "logicalKey",
              "startAt",
              "endAt"
            ],
            "properties": {
              "logicalKey": {
                "type": "string"
              },
              "startAt": {
                "type": "string",
                "format": "date-time"
              },
              "endAt": {
                "type": "string",
                "format": "date-time"
              }
            }
          },
          "next": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "logicalKey",
              "startAt",
              "endAt"
            ],
            "properties": {
              "logicalKey": {
                "type": "string"
              },
              "startAt": {
                "type": "string",
                "format": "date-time"
              },
              "endAt": {
                "type": "string",
                "format": "date-time"
              }
            }
          },
          "requiredScopes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "preserved": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "sessionId",
              "formIds",
              "productIds",
              "fundraiserIds",
              "livretIds"
            ],
            "properties": {
              "sessionId": {
                "type": "string"
              },
              "formIds": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "productIds": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "fundraiserIds": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "livretIds": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "seriesBecomesCustom": {
            "type": "boolean"
          },
          "campaignsUnchanged": {
            "type": "boolean",
            "enum": [
              true
            ]
          }
        }
      },
      "EventLifecycleRescheduleResult": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "projectId",
          "sessionId",
          "commandId",
          "revision",
          "startAt",
          "endAt",
          "preserved"
        ],
        "properties": {
          "projectId": {
            "type": "string"
          },
          "sessionId": {
            "type": "string"
          },
          "commandId": {
            "type": "string",
            "format": "uuid"
          },
          "revision": {
            "type": "integer",
            "minimum": 2
          },
          "startAt": {
            "type": "string",
            "format": "date-time"
          },
          "endAt": {
            "type": "string",
            "format": "date-time"
          },
          "preserved": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "sessionId",
              "formIds",
              "productIds",
              "fundraiserIds",
              "livretIds"
            ],
            "properties": {
              "sessionId": {
                "type": "string"
              },
              "formIds": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "productIds": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "fundraiserIds": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "livretIds": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
