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

# Événements

OpenAPI 3.0.3 · API 2.0.0

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

Événements publics en lecture seule. Le catalogue regroupe les affiches, les sessions et les groupes par site. Les routes historiques listent les sessions autonomes. Autorisation requise : `events:read`.

## Opérations

## GET /events

Lister les événements autonomes

`list_events`

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

### Authentification

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

### Permissions requises

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

### Paramètres

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

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

### Réponses

#### HTTP 200

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

#### HTTP 401

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

#### HTTP 403

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

### OpenAPI

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

## GET /events/{id}

Obtenir un événement autonome

`get_event`

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

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
    "format": "uuid"
  },
  "description": "Identifiant de la ressource cible existante, renvoyé par son opération de liste ou de lecture autorisée. Ne générez jamais un nouvel UUID pour cibler un enregistrement existant."
}
```

### Réponses

#### HTTP 200

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

#### HTTP 404

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

### OpenAPI

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

## GET /events/catalog

Lister le catalogue unifié des événements publics

`list_event_catalog`

Autorisation requise : `events:read`. Liste les affiches, les sessions autonomes ou groupées, ainsi que les groupes publics et système visibles sur le site choisi. Filtrez par kind ou indiquez groupId pour lister les sessions d’un groupe. Les dates du groupe couvrent ses sessions. Un filtre de dates retient le groupe si au moins une session commence dans l’intervalle. Les éléments sont triés par date de début décroissante, suivis de ceux sans date. Conservez les filtres pour réutiliser le curseur.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

```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": "kind",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "POSTER",
      "SESSION",
      "GROUP",
      "SYSTEM_GROUP"
    ]
  }
}
```

```json
{
  "name": "groupId",
  "in": "query",
  "schema": {
    "type": "string",
    "minLength": 1
  },
  "description": "Renvoyer les sessions de ce groupe."
}
```

```json
{
  "name": "startsFrom",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Inclure les événements qui commencent à cette date et heure ou après."
}
```

```json
{
  "name": "startsBefore",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Inclure les événements qui commencent strictement avant cette date et heure."
}
```

### Réponses

#### HTTP 200

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

#### HTTP 400

```json
{
  "description": "INVALID_EVENT_KIND, INVALID_GROUP_ID, INVALID_DATE_RANGE ou INVALID_CURSOR",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "INVALID_EVENT_KIND or INVALID_GROUP_ID or INVALID_DATE_RANGE or INVALID_CURSOR"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

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

#### HTTP 404

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

### OpenAPI

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

## GET /events/catalog/{kind}/{id}

Consulter un élément du catalogue des événements publics

`get_event_catalog_item`

Autorisation requise : `events:read`. Utilisez les valeurs kind et id renvoyées par le catalogue et le même virtualId. Pour parcourir les sessions d’un groupe, appelez list_event_catalog en passant son id dans groupId.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "kind",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "enum": [
      "POSTER",
      "SESSION",
      "GROUP",
      "SYSTEM_GROUP"
    ]
  }
}
```

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string"
  },
  "description": "Identifiant de l’élément renvoyé par le catalogue des événements."
}
```

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string"
  },
  "description": "Façade (site virtuel) à cibler. Omettre = site principal. Listez les façades avec GET /site/facades."
}
```

### Réponses

#### HTTP 200

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

#### HTTP 400

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

#### HTTP 401

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

#### HTTP 403

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

#### HTTP 404

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

### OpenAPI

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

## POST /events/{id}/communications/preview

Prévisualiser une communication par email aux inscrits admis d’un événement

`preview_event_registrant_communication`

Aperçu pur : aucune campagne, journal, file, synchronisation CRM ni effet auprès d’un prestataire. Fournir un subject/message explicite et examiner chaque état de l’audience native. Transmettre à send l’intégralité de l’entrée vérifiée et expectedSnapshot sans les modifier. L’aperçu nécessite uniquement les droits de lecture cumulatifs et n’accorde aucun droit d’envoi. Nécessite events:read, forms:read, forms_submit:read, contacts:read ET messages:read. Les clés limitées à des collectes sont refusées. Un formId explicite doit actuellement appartenir à la séance. Seules les inscriptions courantes VALIDE, non archivées et non supprimées, avec attribution exacte du snapshot formData.id/organisation/pe, sont admises. Les références absentes, étrangères, scalaires sous forme de tableaux ou contradictoires sont refusées ; aucun repli sur le formulaire courant, une catégorie CRM ou tous les contacts. Le propriétaire natif de l’audience de formulaire lit l’identité principale et les champs typés de contact/email, ainsi que les participants des articles explicitement sélectionnés. includePrimary vaut true par défaut et includeParticipants vaut false ; les deux ne peuvent pas valoir false. Les coordonnées CRM courantes remplacent celles du snapshot lié ; les champs d’identité indépendants restent des candidats distincts. La validation native exclut les personnes décédées, les adresses invalides ou désinscrites, et dédoublonne par email normalisé, pas par inscription ni personne. excludedKeys peut exclure une occurrence ou toutes les occurrences d’un email via la clé d’exclusion renvoyée. Utiliser list_messaging_configs pour identifier l’expéditeur email sans demander de secrets. Un seul emailConfigId doit désigner une configuration Email CONFIG courante de l’organisation ; aucun secret privé n’est renvoyé. Les lectures sont limitées à 2000 inscriptions admises, 2000 références/articles, 20000 désinscriptions de l’organisation et 200 éléments d’audience, y compris les éléments exclus ou en doublon ; tout dépassement refuse l’opération entière. Aucun paramètre de requête n’est accepté. Les réponses ne contiennent ni moyen de paiement réutilisable ni configuration brute/privée. Cette capacité envoie uniquement des communications ordinaires EMAIL, sans opération de paiement, programmation, canal de repli ni relance financière implicite. reservationStatus=COMPLETION_PROVEN nécessite une preuve de clôture écrite seulement après les acquittements positifs de la file et du journal terminal ; un simple QUEUED enregistré ne libère jamais la ressource. RETAINED maintient la réservation indisponible pour une nouvelle commande. Une erreur accessoire d’enregistrement de clôture n’efface pas l’effet de file positivement prouvé dans la réponse initiale, queueAdmission=CONFIRMED conserve un effet de file positivement acquitté indépendamment du journal terminal ou de la tenue de la preuve de clôture. UNKNOWN ne signifie jamais échec. Une observation ultérieure peut montrer QUEUED enregistré sans marqueur de clôture ; reservationStatus reste RETAINED et ne peut autoriser une autre commande. 

### Authentification

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

### Permissions requises

```json
{
  "accepted": "events:read",
  "additional": [
    "forms:read",
    "forms_submit:read",
    "contacts:read",
    "messages:read"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "formId": {
            "type": "string",
            "format": "uuid"
          },
          "emailConfigId": {
            "type": "string",
            "format": "uuid"
          },
          "subject": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$"
          },
          "message": {
            "type": "string",
            "minLength": 1,
            "maxLength": 20000,
            "pattern": "\\S"
          },
          "includePrimary": {
            "type": "boolean"
          },
          "includeParticipants": {
            "type": "boolean"
          },
          "excludedKeys": {
            "type": "array",
            "maxItems": 200,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            }
          }
        },
        "required": [
          "formId",
          "emailConfigId",
          "subject",
          "message"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Audience d’événement qualifiée ou observation de commande enregistrée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/EventCommunicationPreview"
          }
        },
        "required": [
          "success",
          "data"
        ]
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_EVENT_COMMUNICATION_INPUT, INVALID_REMINDER_INPUT ou UNEXPECTED_REQUEST_BODY. Retirer les champs non déclarés et les paramètres de requête.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_PRINCIPAL ou CAMPAIGN_RESTRICTED_KEY. L’envoi nécessite l’attribution explicite de events:communications:send et messages:send en plus de chaque droit de lecture.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND. Une séance, un formulaire, un contact, une configuration d’expéditeur ou une commande du même principal exact est indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "EVENT_COMMUNICATION_AUDIENCE_CHANGED exige un nouvel aperçu et une vérification humaine de l’audience visée. EVENT_COMMUNICATION_AUDIENCE_EMPTY, EVENT_COMMUNICATION_ATTRIBUTION_UNPROVEN, EVENT_COMMUNICATION_SOURCE_UNPROVEN ou EVENT_COMMUNICATION_SOURCE_LIMIT refuse les sources incomplètes ou ambiguës. EVENT_COMMUNICATION_PREVIOUS_RESULT_UNKNOWN bloque une nouvelle commande pour la même séance/formulaire après un résultat antérieur non résolu. IDEMPOTENCY_CONFLICT interdit de réutiliser une clé avec une entrée différente. Aucun résultat incertain n’autorise un réessai.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "FORM_AUDIENCE_LIMIT. La limite native d’extraction de 20000 candidats ou sa structure identitaire imbriquée bornée est dépassée. Aucune audience partielle, campagne ni file n’est créée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR. Une réponse absente laisse le résultat inconnu ; observer la requête existante.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "REMINDER_JOURNAL_UNCERTAIN ou EVENT_COMMUNICATION_RESERVATION_UNCERTAIN. L’acquittement d’une réservation durable est absent ou contradictoire ; aucun effet ultérieur n’est autorisé. Observer la même requête sans changer sa clé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

### OpenAPI

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

## POST /events/{id}/communications/send

Mettre en file une communication aux inscrits explicitement vérifiée

`send_event_registrant_communication`

Nécessite l’attribution explicite de events:communications:send ET messages:send en plus de tous les droits de lecture. Prévisualiser d’abord le même formulaire, expéditeur, contenu et public. Fournir son expectedSnapshot exact et un nouvel idempotencyKey UUID uniquement pour cette nouvelle intention réelle. Un journal durable et une réservation exclusive de séance/formulaire précèdent la création de campagne et insertMany. Chaque formulaire, inscription, identité, désinscription et expéditeur courant est de nouveau admis après la réservation, juste avant la mise en file. Les modifications concurrentes ultérieures ne constituent pas un snapshot atomique. Le moteur natif de destinataire CRM crée des documents EMAIL exacts dans la file d’une campagne native VALIDATE. QUEUED exige acknowledged=true, les identifiants insérés et comptes exacts, avec écritures explicites majority+journalisées. PENDING/UNCERTAIN et queueRead=UNAVAILABLE ne signifient jamais échec ni livraison ; observer la même requête, ne jamais réessayer avec une autre clé. Un effet inconnu/partiel conserve la réservation et bloque de nouveaux envois pour cette séance/formulaire. La même clé et la même entrée renvoient le résultat précédent sans nouvel effet ; une entrée différente donne IDEMPOTENCY_CONFLICT. QUEUED prouve uniquement l’admission en file. SMTP_ACCEPTED indique l’acceptation par le prestataire ; DELIVERED exige un rapport explicite cohérent et deliveredAt. Aucune interrogation de prestataire ni réexécution automatique. Nécessite events:read, forms:read, forms_submit:read, contacts:read ET messages:read. Les clés limitées à des collectes sont refusées. Un formId explicite doit actuellement appartenir à la séance. Seules les inscriptions courantes VALIDE, non archivées et non supprimées, avec attribution exacte du snapshot formData.id/organisation/pe, sont admises. Les références absentes, étrangères, scalaires sous forme de tableaux ou contradictoires sont refusées ; aucun repli sur le formulaire courant, une catégorie CRM ou tous les contacts. Le propriétaire natif de l’audience de formulaire lit l’identité principale et les champs typés de contact/email, ainsi que les participants des articles explicitement sélectionnés. includePrimary vaut true par défaut et includeParticipants vaut false ; les deux ne peuvent pas valoir false. Les coordonnées CRM courantes remplacent celles du snapshot lié ; les champs d’identité indépendants restent des candidats distincts. La validation native exclut les personnes décédées, les adresses invalides ou désinscrites, et dédoublonne par email normalisé, pas par inscription ni personne. excludedKeys peut exclure une occurrence ou toutes les occurrences d’un email via la clé d’exclusion renvoyée. Utiliser list_messaging_configs pour identifier l’expéditeur email sans demander de secrets. Un seul emailConfigId doit désigner une configuration Email CONFIG courante de l’organisation ; aucun secret privé n’est renvoyé. Les lectures sont limitées à 2000 inscriptions admises, 2000 références/articles, 20000 désinscriptions de l’organisation et 200 éléments d’audience, y compris les éléments exclus ou en doublon ; tout dépassement refuse l’opération entière. Aucun paramètre de requête n’est accepté. Les réponses ne contiennent ni moyen de paiement réutilisable ni configuration brute/privée. Cette capacité envoie uniquement des communications ordinaires EMAIL, sans opération de paiement, programmation, canal de repli ni relance financière implicite. reservationStatus=COMPLETION_PROVEN nécessite une preuve de clôture écrite seulement après les acquittements positifs de la file et du journal terminal ; un simple QUEUED enregistré ne libère jamais la ressource. RETAINED maintient la réservation indisponible pour une nouvelle commande. Une erreur accessoire d’enregistrement de clôture n’efface pas l’effet de file positivement prouvé dans la réponse initiale, queueAdmission=CONFIRMED conserve un effet de file positivement acquitté indépendamment du journal terminal ou de la tenue de la preuve de clôture. UNKNOWN ne signifie jamais échec. Une observation ultérieure peut montrer QUEUED enregistré sans marqueur de clôture ; reservationStatus reste RETAINED et ne peut autoriser une autre commande. Toujours vide. Ce champ réservé ne fournit aucun statut de destinataire ; les preuves observées de la file figurent uniquement dans recipients et sont qualifiées par queueRead et queueAdmission.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "events:communications:send",
  "additional": [
    "events:read",
    "forms:read",
    "forms_submit:read",
    "contacts:read",
    "messages:read",
    "messages:send"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "formId": {
            "type": "string",
            "format": "uuid"
          },
          "emailConfigId": {
            "type": "string",
            "format": "uuid"
          },
          "subject": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$"
          },
          "message": {
            "type": "string",
            "minLength": 1,
            "maxLength": 20000,
            "pattern": "\\S"
          },
          "includePrimary": {
            "type": "boolean"
          },
          "includeParticipants": {
            "type": "boolean"
          },
          "excludedKeys": {
            "type": "array",
            "maxItems": 200,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            }
          },
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedSnapshot": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          }
        },
        "required": [
          "formId",
          "emailConfigId",
          "subject",
          "message",
          "idempotencyKey",
          "expectedSnapshot"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Audience d’événement qualifiée ou observation de commande enregistrée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/EventCommunicationCommand"
          }
        },
        "required": [
          "success",
          "data"
        ]
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_EVENT_COMMUNICATION_INPUT, INVALID_REMINDER_INPUT ou UNEXPECTED_REQUEST_BODY. Retirer les champs non déclarés et les paramètres de requête.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_PRINCIPAL ou CAMPAIGN_RESTRICTED_KEY. L’envoi nécessite l’attribution explicite de events:communications:send et messages:send en plus de chaque droit de lecture.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND. Une séance, un formulaire, un contact, une configuration d’expéditeur ou une commande du même principal exact est indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "EVENT_COMMUNICATION_AUDIENCE_CHANGED exige un nouvel aperçu et une vérification humaine de l’audience visée. EVENT_COMMUNICATION_AUDIENCE_EMPTY, EVENT_COMMUNICATION_ATTRIBUTION_UNPROVEN, EVENT_COMMUNICATION_SOURCE_UNPROVEN ou EVENT_COMMUNICATION_SOURCE_LIMIT refuse les sources incomplètes ou ambiguës. EVENT_COMMUNICATION_PREVIOUS_RESULT_UNKNOWN bloque une nouvelle commande pour la même séance/formulaire après un résultat antérieur non résolu. IDEMPOTENCY_CONFLICT interdit de réutiliser une clé avec une entrée différente. Aucun résultat incertain n’autorise un réessai.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "FORM_AUDIENCE_LIMIT. La limite native d’extraction de 20000 candidats ou sa structure identitaire imbriquée bornée est dépassée. Aucune audience partielle, campagne ni file n’est créée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR. Une réponse absente laisse le résultat inconnu ; observer la requête existante.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "REMINDER_JOURNAL_UNCERTAIN ou EVENT_COMMUNICATION_RESERVATION_UNCERTAIN. L’acquittement d’une réservation durable est absent ou contradictoire ; aucun effet ultérieur n’est autorisé. Observer la même requête sans changer sa clé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

### OpenAPI

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

## GET /events/{id}/communications/commands/{requestId}

Observer une commande de communication et les preuves courantes de la file

`get_event_registrant_communication_command`

Observation en lecture seule pour la même organisation et le même principal API que la requête. La séance/le formulaire courants et les contacts liés aux lignes de file sont de nouveau admis. Aucun corps de requête non vide n’est accepté. UNKNOWN ou queueRead=UNAVAILABLE signifie que la preuve de livraison est indisponible ; QUEUED_OR_IN_FLIGHT ne distingue pas une ligne en attente d’un worker actif. SMTP_ACCEPTED ne prouve pas l’arrivée en boîte de réception. Une commande reste UNCERTAIN après un acquittement de file absent/partiel, même si des lignes de file deviennent lisibles. L’observation n’envoie rien, n’interroge aucun prestataire, ne libère aucune réservation non résolue et n’autorise aucun réessai. Nécessite events:read, forms:read, forms_submit:read, contacts:read ET messages:read. Les clés limitées à des collectes sont refusées. Un formId explicite doit actuellement appartenir à la séance. Seules les inscriptions courantes VALIDE, non archivées et non supprimées, avec attribution exacte du snapshot formData.id/organisation/pe, sont admises. Les références absentes, étrangères, scalaires sous forme de tableaux ou contradictoires sont refusées ; aucun repli sur le formulaire courant, une catégorie CRM ou tous les contacts. Le propriétaire natif de l’audience de formulaire lit l’identité principale et les champs typés de contact/email, ainsi que les participants des articles explicitement sélectionnés. includePrimary vaut true par défaut et includeParticipants vaut false ; les deux ne peuvent pas valoir false. Les coordonnées CRM courantes remplacent celles du snapshot lié ; les champs d’identité indépendants restent des candidats distincts. La validation native exclut les personnes décédées, les adresses invalides ou désinscrites, et dédoublonne par email normalisé, pas par inscription ni personne. excludedKeys peut exclure une occurrence ou toutes les occurrences d’un email via la clé d’exclusion renvoyée. Utiliser list_messaging_configs pour identifier l’expéditeur email sans demander de secrets. Un seul emailConfigId doit désigner une configuration Email CONFIG courante de l’organisation ; aucun secret privé n’est renvoyé. Les lectures sont limitées à 2000 inscriptions admises, 2000 références/articles, 20000 désinscriptions de l’organisation et 200 éléments d’audience, y compris les éléments exclus ou en doublon ; tout dépassement refuse l’opération entière. Aucun paramètre de requête n’est accepté. Les réponses ne contiennent ni moyen de paiement réutilisable ni configuration brute/privée. Cette capacité envoie uniquement des communications ordinaires EMAIL, sans opération de paiement, programmation, canal de repli ni relance financière implicite. reservationStatus=COMPLETION_PROVEN nécessite une preuve de clôture écrite seulement après les acquittements positifs de la file et du journal terminal ; un simple QUEUED enregistré ne libère jamais la ressource. RETAINED maintient la réservation indisponible pour une nouvelle commande. Une erreur accessoire d’enregistrement de clôture n’efface pas l’effet de file positivement prouvé dans la réponse initiale, queueAdmission=CONFIRMED conserve un effet de file positivement acquitté indépendamment du journal terminal ou de la tenue de la preuve de clôture. UNKNOWN ne signifie jamais échec. Une observation ultérieure peut montrer QUEUED enregistré sans marqueur de clôture ; reservationStatus reste RETAINED et ne peut autoriser une autre commande. Toujours vide. Ce champ réservé ne fournit aucun statut de destinataire ; les preuves observées de la file figurent uniquement dans recipients et sont qualifiées par queueRead et queueAdmission.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "events:communications:send",
  "additional": [
    "events:read",
    "forms:read",
    "forms_submit:read",
    "contacts:read",
    "messages:read",
    "messages:send"
  ]
}
```

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

```json
{
  "name": "requestId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Audience d’événement qualifiée ou observation de commande enregistrée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/EventCommunicationCommand"
          }
        },
        "required": [
          "success",
          "data"
        ]
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_EVENT_COMMUNICATION_INPUT, INVALID_REMINDER_INPUT ou UNEXPECTED_REQUEST_BODY. Retirer les champs non déclarés et les paramètres de requête.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_PRINCIPAL ou CAMPAIGN_RESTRICTED_KEY. L’envoi nécessite l’attribution explicite de events:communications:send et messages:send en plus de chaque droit de lecture.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "NOT_FOUND. Une séance, un formulaire, un contact, une configuration d’expéditeur ou une commande du même principal exact est indisponible.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "EVENT_COMMUNICATION_AUDIENCE_CHANGED exige un nouvel aperçu et une vérification humaine de l’audience visée. EVENT_COMMUNICATION_AUDIENCE_EMPTY, EVENT_COMMUNICATION_ATTRIBUTION_UNPROVEN, EVENT_COMMUNICATION_SOURCE_UNPROVEN ou EVENT_COMMUNICATION_SOURCE_LIMIT refuse les sources incomplètes ou ambiguës. EVENT_COMMUNICATION_PREVIOUS_RESULT_UNKNOWN bloque une nouvelle commande pour la même séance/formulaire après un résultat antérieur non résolu. IDEMPOTENCY_CONFLICT interdit de réutiliser une clé avec une entrée différente. Aucun résultat incertain n’autorise un réessai.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 413

```json
{
  "description": "FORM_AUDIENCE_LIMIT. La limite native d’extraction de 20000 candidats ou sa structure identitaire imbriquée bornée est dépassée. Aucune audience partielle, campagne ni file n’est créée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR. Une réponse absente laisse le résultat inconnu ; observer la requête existante.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 503

```json
{
  "description": "REMINDER_JOURNAL_UNCERTAIN ou EVENT_COMMUNICATION_RESERVATION_UNCERTAIN. L’acquittement d’une réservation durable est absent ou contradictoire ; aucun effet ultérieur n’est autorisé. Observer la même requête sans changer sa clé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "events:communications:send",
  "x-unisoft-additional-scopes": [
    "events:read",
    "forms:read",
    "forms_submit:read",
    "contacts:read",
    "messages:read",
    "messages:send"
  ],
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /events/{id}/finance

Consulter les finances qualifiées des inscriptions par séance, association et devise

`get_event_session_finance`

Nécessite events:read, forms:read, forms_submit:read ET paiements:read. Les clés limitées à des collectes sont refusées, car les inscriptions de séance/formulaire n’ont pas de propriétaire indépendant d’appartenance à une collecte. Lecture seule : aucun débit, remboursement, rapprochement, cache ni échéancier persistant modifié. Il s’agit de REGISTRATION_FINANCE_ONLY, sans bilan budgétaire complet, bénéfice ni relevé bancaire de l’événement. L’attribution à une séance provient du snapshot COURANT ENREGISTRÉ formData.pe de l’inscription, avec formulaire/organisation exacts et liens paiement FORM -> inscription puis parentTypeId -> formulaire. Ne jamais se rabattre sur le pe courant du formulaire lorsqu’un snapshot manque. Une édition ordinaire conserve le snapshot ; une nouvelle tarification personnalisée acceptée peut le remplacer, ce qui ne constitue pas un grand livre historique immuable. Un formulaire déplacé dans une autre séance ne réattribue pas un snapshot enregistré valide. Chaque séance/formulaire/inscription/paiement/abonnement interprété est de nouveau autorisé dans l’organisation ; les liens obsolètes, supprimés, absents, étrangers, scalaires sous forme de tableaux ou contradictoires sont refusés au lieu d’être omis en silence. Les cartes d’affectation croisée vers des promesses exigent un propriétaire dédié et sont refusées, y compris une carte explicitement vide. Les groupes restent séparés par association et devise enregistrée ; aucune devise par défaut, conversion ni somme entre groupes n’est fournie. Les montants sont en unités mineures (5000 = 50.00 EUR) ; forms_submit.total est déjà en unités mineures. L’engagement accepté inclut uniquement les inscriptions courantes VALIDE non archivées. L’activité de paiement comprend tous les états/statuts d’archive d’inscription admis ; les enregistrements importés COMPLETED sont inclus, contrairement aux totaux budgétaires monétaires. completedAmountMinor compte les résultats monétaires courants COMPLETED, sans prouver le règlement bancaire ; une autorisation Axepta peut précéder la capture. recordedRefundedAmountMinor est le montant intégral d’un REFUNDED avec remboursement SUCCEEDED enregistré et cohérent, sans preuve de crédit bancaire. REFUND_PENDING ou un état de remboursement inconnu laisse retainedRecordedMinor et le acceptedOutstandingMinor concerné à null, jamais à zéro. Les tentatives inconnues/non terminales rendent également le conservé/reste indisponible ; leur montant nominal n’est pas un paiement reçu. Les montants NATURE sont des observations nominales distinctes, pas de l’argent. Le propriétaire canonique d’inscription calcule l’engagement accepté restant par inscription, borné à zéro ; un trop-perçu ne règle pas une autre inscription. netAfterFeesMinor est disponible uniquement pour des résultats conservés connus avec frais bancaires/de service explicitement nuls ; des frais non nuls à devise/provenance inconnue ou des champs de frais absents le laissent à null. profitMinor vaut toujours null, car les dépenses/bénéfices et l’attribution historique des cagnottes sont des facettes indisponibles. Une population admise vide renvoie groups=[], sans inventer EUR ni un budget complet nul. Les lectures sont bornées à 500 formulaires admis, 10000 inscriptions candidates, 10000 paiements, 200 groupes devise/association, 500 séances liées et 500 abonnements liés ; un dépassement renvoie EVENT_FINANCIAL_SOURCE_LIMIT plutôt que des totaux partiels. Les lectures séparées ne sont pas un snapshot atomique. Aucun paramètre de requête ni corps de requête non vide n’est accepté. Aucune identité de donateur, snapshot de reçu, moyen réutilisable, référence prestataire, erreur brute ni configuration privée n’est renvoyé.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Groupes financiers enregistrés des inscriptions avec facettes indisponibles explicites.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/EventFinanceObservation"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_REMINDER_INPUT ou UNEXPECTED_REQUEST_BODY. Retirer les entrées de requête/corps non prises en charge.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Authentification absente ou invalide.",
  "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, INVALID_PRINCIPAL ou 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": "NOT_FOUND : une séance, un formulaire, une inscription ou un abonnement interprété est absent, supprimé, étranger ou ambigu.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "EVENT_ATTRIBUTION_SNAPSHOT_REQUIRED, EVENT_FINANCIAL_ATTRIBUTION_UNPROVEN, EVENT_PAYMENT_ATTRIBUTION_UNPROVEN, EVENT_FINANCIAL_DENOMINATION_UNPROVEN, EVENT_FINANCIAL_ASSOCIATION_UNAVAILABLE, EVENT_CROSS_ALLOCATION_REVIEW_REQUIRED, EVENT_PAYMENT_INSTRUMENT_UNVERIFIED, EVENT_FINANCIAL_HISTORY_INVALID, EVENT_FINANCIAL_AMOUNT_OVERFLOW ou EVENT_FINANCIAL_SOURCE_LIMIT. Vérifier les données propriétaires ; aucune devise par défaut, aucun repli sur la séance courante ni total partiel n’est renvoyé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "INTERNAL_ERROR. Aucun résultat financier partiel n’est renvoyé.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /events/calendar

Découvrir l’URL publique d’abonnement au calendrier des événements

`get_event_calendar`

Autorisation events:read requise sur une connexion d’organisation non restreinte. Retourne l’URL du flux public et sa couverture ainsi que ses diagnostics courants ; n’abonne pas l’utilisateur, ne crée pas de jeton de calendrier et ne modifie aucun enregistrement métier. L’URL peut être utilisée directement par une application de calendrier sans clé API. Flux iCalendar public de l’organisation et du site principal ou de la façade exacte sélectionnés. Seul le catalogue public canonique existant est lu : affiches publiques et séances réelles autonomes ou de groupe, y compris les séances de Chabbat du site autorisé. Les cartes synthétiques de groupe ne sont pas des occurrences de calendrier : groupes et séances ne sont donc pas dupliqués. UID reste stable par environnement, organisation, façade, type d’événement et id source ; une modification de date ou de titre conserve cet UID. Les instants sont émis en UTC à partir de dates enregistrées non ambiguës ; aucun horaire religieux n’est calculé. Le champ dateFin d’une affiche est une borne d’affichage et ne sert jamais de fin d’événement. Aucune fenêtre de dates par défaut ni pagination ne masque silencieusement des événements : au plus 5000 occurrences, 10000 lignes sources et 8388608 octets de calendrier sont admis, sinon la réponse entière est refusée. Les entrées sans début enregistré sont exclues avec un compteur explicite ; les dates non vides ambiguës ou les références historiques contradictoires font refuser la réponse entière. La réponse est un instantané courant complet des événements publics datés dans les éventuels filtres explicites de début. Les entrées retirées ou dépubliées disparaissent à l’actualisation ; il n’existe ni journal persistant d’annulation, ni historique de tombstones, ni garantie qu’un client de calendrier donné retire un élément absent. La fréquence d’interrogation du client détermine le délai de mise à jour. Aucun participant, identité CRM, réponse, enregistrement de donateur, identifiant réutilisable, jeton de calendrier privé ni action d’inscription ou de paiement n’est exposé.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{1,128}$"
  },
  "description": "Façade existante de cette organisation. L’omission sélectionne le site public principal, jamais la première façade."
}
```

```json
{
  "name": "lang",
  "in": "query",
  "schema": {
    "type": "string",
    "pattern": "^[a-z]{2}$"
  },
  "description": "Langue de contenu activée. L’omission utilise la langue par défaut de l’organisation. Un champ traduit absent reprend sa valeur racine."
}
```

```json
{
  "name": "from",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Filtre facultatif et inclusif sur l’instant de début, avec fuseau explicite. Aucune fenêtre glissante implicite n’est appliquée."
}
```

```json
{
  "name": "to",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Filtre facultatif et exclusif sur l’instant de début, avec fuseau explicite. Si les deux bornes sont fournies, from doit précéder to."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "URL publique et couverture de l’instantané courant, pas un abonnement déjà effectué dans le client.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EventCalendarDiscoveryResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Options de calendrier invalides, intervalle avec fuseau invalide ou langue désactivée. Aucun effet métier ne se produit.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Clé API absente ou invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "Autorisation events:read absente ou connexion restreinte à une campagne.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Organisation ou façade indisponible. Aucune donnée privée de l’organisation n’est retournée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Source ou date ambiguë, modification concurrente de source, URL du site indisponible ou plafond de volume atteint. Le flux entier est refusé ; il n’est jamais tronqué silencieusement.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Le calendrier public n’a pas pu être lu. Aucun abonnement, aucune publication ni action financière n’a été effectué.",
  "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 /events/calendar/{organisationId}.ics

Lire le calendrier public des événements au format iCalendar

`download_public_event_calendar`

Flux iCalendar public de l’organisation et du site principal ou de la façade exacte sélectionnés. Seul le catalogue public canonique existant est lu : affiches publiques et séances réelles autonomes ou de groupe, y compris les séances de Chabbat du site autorisé. Les cartes synthétiques de groupe ne sont pas des occurrences de calendrier : groupes et séances ne sont donc pas dupliqués. UID reste stable par environnement, organisation, façade, type d’événement et id source ; une modification de date ou de titre conserve cet UID. Les instants sont émis en UTC à partir de dates enregistrées non ambiguës ; aucun horaire religieux n’est calculé. Le champ dateFin d’une affiche est une borne d’affichage et ne sert jamais de fin d’événement. Aucune fenêtre de dates par défaut ni pagination ne masque silencieusement des événements : au plus 5000 occurrences, 10000 lignes sources et 8388608 octets de calendrier sont admis, sinon la réponse entière est refusée. Les entrées sans début enregistré sont exclues avec un compteur explicite ; les dates non vides ambiguës ou les références historiques contradictoires font refuser la réponse entière. La réponse est un instantané courant complet des événements publics datés dans les éventuels filtres explicites de début. Les entrées retirées ou dépubliées disparaissent à l’actualisation ; il n’existe ni journal persistant d’annulation, ni historique de tombstones, ni garantie qu’un client de calendrier donné retire un élément absent. La fréquence d’interrogation du client détermine le délai de mise à jour. Aucun participant, identité CRM, réponse, enregistrement de donateur, identifiant réutilisable, jeton de calendrier privé ni action d’inscription ou de paiement n’est exposé.

### Authentification

```json
[]
```

### Permissions requises

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

### Paramètres

```json
{
  "name": "organisationId",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{1,128}$"
  },
  "description": "Identifiant canonique de l’organisation, pas un domaine, une clé API ni un jeton de calendrier privé."
}
```

```json
{
  "name": "virtualId",
  "in": "query",
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{1,128}$"
  },
  "description": "Façade existante de cette organisation. L’omission sélectionne le site public principal, jamais la première façade."
}
```

```json
{
  "name": "lang",
  "in": "query",
  "schema": {
    "type": "string",
    "pattern": "^[a-z]{2}$"
  },
  "description": "Langue de contenu activée. L’omission utilise la langue par défaut de l’organisation. Un champ traduit absent reprend sa valeur racine."
}
```

```json
{
  "name": "from",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Filtre facultatif et inclusif sur l’instant de début, avec fuseau explicite. Aucune fenêtre glissante implicite n’est appliquée."
}
```

```json
{
  "name": "to",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "date-time"
  },
  "description": "Filtre facultatif et exclusif sur l’instant de début, avec fuseau explicite. Si les deux bornes sont fournies, from doit précéder to."
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Instantané iCalendar complet des événements publics datés. X-Unisoft-Calendar-Event-Count et X-Unisoft-Calendar-Excluded-Undated qualifient son contenu.",
  "headers": {
    "X-Unisoft-Calendar-Event-Count": {
      "schema": {
        "type": "integer",
        "minimum": 0
      }
    },
    "X-Unisoft-Calendar-Excluded-Undated": {
      "schema": {
        "type": "integer",
        "minimum": 0
      }
    },
    "X-Unisoft-Calendar-Deletion-Mode": {
      "schema": {
        "type": "string",
        "enum": [
          "CURRENT_SNAPSHOT"
        ]
      }
    }
  },
  "content": {
    "text/calendar": {
      "schema": {
        "type": "string"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Options de calendrier invalides, intervalle avec fuseau invalide ou langue désactivée. Aucun effet métier ne se produit.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "Organisation ou façade indisponible. Aucune donnée privée de l’organisation n’est retournée.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "Source ou date ambiguë, modification concurrente de source, URL du site indisponible ou plafond de volume atteint. Le flux entier est refusé ; il n’est jamais tronqué silencieusement.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "Le calendrier public n’a pas pu être lu. Aucun abonnement, aucune publication ni action financière n’a été effectué.",
  "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": null,
  "x-unisoft-mcp": false
}
```

## Schémas

```json
{
  "components": {
    "schemas": {
      "Event": {
        "type": "object",
        "description": "Session autonome de Parcours d’Événement : occasion datée à laquelle les visiteurs peuvent s’inscrire ou contribuer. Lecture seule — les événements (avec leurs formulaires, cagnottes et livrets budgétaires) sont créés dans l’application admin. Les groupes d’événements à sessions multiples et les groupes système (par ex. Shabbat, exposé via l’API Travel) ne sont PAS listés ici. Les champs texte localisés contiennent la langue par défaut à la racine, avec des surcharges facultatives par langue (`fr`/`en`/`he`/`de`/`gr`…).",
        "properties": {
          "id": {
            "type": "string",
            "readOnly": true
          },
          "name": {
            "type": "string",
            "nullable": true,
            "readOnly": true,
            "description": "Titre public de la session."
          },
          "description": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "dateEvent": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "description": "Date/heure de début."
          },
          "dateFin": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "description": "Date/heure de fin."
          },
          "dateDebut": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true,
            "description": "Date à partir de laquelle l’événement devient visible."
          },
          "image": {
            "type": "string",
            "nullable": true,
            "readOnly": true,
            "description": "Affiche/illustration (nom de fichier hébergé ou URL)."
          },
          "adresse": {
            "type": "string",
            "nullable": true,
            "readOnly": true,
            "description": "Adresse du lieu, si définie."
          },
          "links": {
            "type": "array",
            "readOnly": true,
            "items": {
              "$ref": "#/components/schemas/EventLink"
            },
            "description": "Formulaires d’inscription et cagnottes de dons actifs associés à cet événement."
          }
        }
      },
      "EventLink": {
        "type": "object",
        "description": "Lien d’action public pour l’événement (formulaire d’inscription ou cagnotte de dons).",
        "properties": {
          "name": {
            "type": "string",
            "readOnly": true,
            "description": "Libellé du lien (localisé ; voir les surcharges par langue)."
          },
          "url": {
            "type": "string",
            "readOnly": true,
            "description": "URL publique (page /form/… ou /don/…)."
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "nextCursor": {
            "type": "string",
            "nullable": true
          },
          "hasMore": {
            "type": "boolean"
          },
          "count": {
            "type": "integer"
          }
        }
      },
      "EventCatalogItem": {
        "type": "object",
        "required": [
          "id",
          "kind",
          "groupId",
          "name",
          "description",
          "image",
          "adresse",
          "dateEvent",
          "dateFin",
          "links",
          "i18n"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "kind": {
            "type": "string",
            "enum": [
              "POSTER",
              "SESSION",
              "GROUP",
              "SYSTEM_GROUP"
            ]
          },
          "groupId": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant du groupe auquel appartient la session, ou null."
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "description": {
            "type": "string",
            "nullable": true
          },
          "image": {
            "type": "string",
            "nullable": true
          },
          "adresse": {
            "type": "string",
            "nullable": true
          },
          "dateEvent": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "dateFin": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EventCatalogLink"
            }
          },
          "i18n": {
            "type": "object",
            "additionalProperties": {
              "type": "object",
              "additionalProperties": {
                "type": "string"
              }
            }
          },
          "sessionsCount": {
            "type": "integer",
            "minimum": 0,
            "description": "Nombre total de sessions du groupe avant filtrage par date."
          },
          "extension": {
            "type": "string",
            "description": "Identifiant du module auquel appartient le groupe système, par exemple pour Chabbat."
          }
        }
      },
      "EventCatalogLink": {
        "type": "object",
        "required": [
          "name",
          "url",
          "i18n"
        ],
        "properties": {
          "name": {
            "type": "string",
            "nullable": true
          },
          "url": {
            "type": "string"
          },
          "kind": {
            "type": "string",
            "enum": [
              "registration",
              "fundraising"
            ]
          },
          "targetId": {
            "type": "string",
            "description": "Pour un lien généré vers une ressource vérifiée appartenant à cette organisation et à cette session, identifiant à utiliser avec /forms ou /caisses selon kind. Les liens éditoriaux omettent kind et targetId, même lorsque leur URL copie celle d’une ressource."
          },
          "i18n": {
            "type": "object",
            "additionalProperties": {
              "type": "object",
              "additionalProperties": {
                "type": "string"
              }
            }
          }
        }
      },
      "EventCommunicationPreview": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "sessionId": {
            "type": "string",
            "format": "uuid"
          },
          "formId": {
            "type": "string",
            "format": "uuid"
          },
          "emailConfigId": {
            "type": "string",
            "format": "uuid"
          },
          "channel": {
            "type": "string",
            "enum": [
              "EMAIL"
            ]
          },
          "expectedSnapshot": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "submissionCount": {
            "type": "integer",
            "minimum": 0
          },
          "summary": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "total": {
                "type": "integer",
                "minimum": 0
              },
              "reachable": {
                "type": "integer",
                "minimum": 0
              },
              "duplicates": {
                "type": "integer",
                "minimum": 0
              },
              "excluded": {
                "type": "integer",
                "minimum": 0
              },
              "unavailable": {
                "type": "integer",
                "minimum": 0
              },
              "unsubscribed": {
                "type": "integer",
                "minimum": 0
              }
            },
            "required": [
              "total",
              "reachable",
              "duplicates",
              "excluded",
              "unavailable",
              "unsubscribed"
            ]
          },
          "includePrimary": {
            "type": "boolean"
          },
          "includeParticipants": {
            "type": "boolean"
          },
          "subject": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "recipients": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "key": {
                  "type": "string",
                  "pattern": "^[a-f0-9]{64}$"
                },
                "email": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "ready",
                    "duplicates",
                    "excluded",
                    "unavailable",
                    "unsubscribed"
                  ]
                },
                "submissionId": {
                  "type": "string",
                  "format": "uuid"
                },
                "kind": {
                  "type": "string",
                  "enum": [
                    "primary",
                    "participant"
                  ]
                },
                "exclusionKeys": {
                  "type": "array",
                  "maxItems": 2,
                  "items": {
                    "type": "string",
                    "pattern": "^[a-f0-9]{64}$"
                  }
                }
              },
              "required": [
                "key",
                "email",
                "name",
                "status",
                "submissionId",
                "kind",
                "exclusionKeys"
              ]
            }
          },
          "limits": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "maxSubmissions": {
                "type": "integer",
                "enum": [
                  2000
                ]
              },
              "maxAudienceItems": {
                "type": "integer",
                "enum": [
                  200
                ]
              }
            },
            "required": [
              "maxSubmissions",
              "maxAudienceItems"
            ]
          },
          "previewOnly": {
            "type": "boolean",
            "enum": [
              true
            ]
          }
        },
        "required": [
          "sessionId",
          "formId",
          "emailConfigId",
          "channel",
          "expectedSnapshot",
          "submissionCount",
          "summary",
          "includePrimary",
          "includeParticipants",
          "subject",
          "message",
          "recipients",
          "limits",
          "previewOnly"
        ]
      },
      "EventCommunicationCommand": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "requestId": {
            "type": "string",
            "format": "uuid"
          },
          "action": {
            "type": "string",
            "enum": [
              "SEND"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "PENDING",
              "QUEUED",
              "UNCERTAIN"
            ]
          },
          "requestedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "completedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "targetIds": {
            "type": "array",
            "minItems": 2,
            "maxItems": 2,
            "items": {
              "type": "string",
              "format": "uuid"
            }
          },
          "error": {
            "type": "string",
            "nullable": true
          },
          "outcomes": {
            "type": "array",
            "minItems": 0,
            "maxItems": 0,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {}
            },
            "description": "Toujours vide. Ce champ réservé ne fournit aucun statut de destinataire ; les preuves observées de la file figurent uniquement dans recipients et sont qualifiées par queueRead et queueAdmission."
          },
          "retryable": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "sessionId": {
            "type": "string",
            "format": "uuid"
          },
          "formId": {
            "type": "string",
            "format": "uuid"
          },
          "campaignId": {
            "type": "string",
            "format": "uuid"
          },
          "reservationStatus": {
            "type": "string",
            "enum": [
              "COMPLETION_PROVEN",
              "RETAINED"
            ]
          },
          "queueAdmission": {
            "type": "string",
            "enum": [
              "CONFIRMED",
              "UNKNOWN"
            ]
          },
          "queueRead": {
            "type": "string",
            "enum": [
              "AVAILABLE",
              "UNAVAILABLE"
            ]
          },
          "recipients": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "sendId": {
                  "type": "string",
                  "format": "uuid"
                },
                "state": {
                  "type": "string",
                  "enum": [
                    "QUEUED_OR_IN_FLIGHT",
                    "SMTP_ACCEPTED",
                    "DELIVERED",
                    "FAILED",
                    "CANCELED",
                    "UNKNOWN"
                  ]
                }
              },
              "required": [
                "sendId",
                "state"
              ]
            }
          }
        },
        "required": [
          "requestId",
          "action",
          "status",
          "requestedAt",
          "completedAt",
          "targetIds",
          "error",
          "outcomes",
          "retryable",
          "sessionId",
          "formId",
          "campaignId",
          "reservationStatus",
          "queueAdmission",
          "queueRead",
          "recipients"
        ]
      },
      "EventFinanceObservation": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "sessionId",
          "observedAt",
          "unit",
          "attribution",
          "coverage",
          "groups",
          "snapshot",
          "unavailableFacets",
          "limits",
          "registrationCount",
          "paymentCount",
          "excludedCurrentFormSubmissionsWithOtherSnapshot"
        ],
        "properties": {
          "sessionId": {
            "type": "string",
            "format": "uuid"
          },
          "observedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "unit": {
            "type": "string",
            "enum": [
              "MINOR"
            ]
          },
          "attribution": {
            "type": "string",
            "enum": [
              "REGISTRATION_FORM_SNAPSHOT"
            ]
          },
          "coverage": {
            "type": "string",
            "enum": [
              "REGISTRATION_FINANCE_ONLY"
            ]
          },
          "groups": {
            "type": "array",
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/EventFinanceCurrencyGroup"
            }
          },
          "snapshot": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "unavailableFacets": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "POT_HISTORICAL_SESSION_ATTRIBUTION",
                "EXPENSES_AND_PROFIT",
                "BANK_SETTLEMENT_VERIFICATION"
              ]
            }
          },
          "limits": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "maxForms",
              "maxSubmissions",
              "maxPayments",
              "maxGroups",
              "maxRelatedSessions",
              "maxSubscriptions"
            ],
            "properties": {
              "maxForms": {
                "type": "integer",
                "enum": [
                  500
                ]
              },
              "maxSubmissions": {
                "type": "integer",
                "enum": [
                  10000
                ]
              },
              "maxPayments": {
                "type": "integer",
                "enum": [
                  10000
                ]
              },
              "maxGroups": {
                "type": "integer",
                "enum": [
                  200
                ]
              },
              "maxRelatedSessions": {
                "type": "integer",
                "enum": [
                  500
                ]
              },
              "maxSubscriptions": {
                "type": "integer",
                "enum": [
                  500
                ]
              }
            }
          },
          "registrationCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "paymentCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "excludedCurrentFormSubmissionsWithOtherSnapshot": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          }
        }
      },
      "EventFinanceCurrencyGroup": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "assoc",
          "currency",
          "registrationCount",
          "acceptedRegistrationCount",
          "acceptedCommitmentMinor",
          "completedPaymentCount",
          "completedAmountMinor",
          "recordedRefundedPaymentCount",
          "recordedRefundedAmountMinor",
          "pendingRefundPaymentCount",
          "pendingRefundAmountMinor",
          "unresolvedAttemptCount",
          "unresolvedAttemptAmountMinor",
          "inKindPaymentCount",
          "inKindNominalAmountMinor",
          "importedCompletedPaymentCount",
          "retainedRecordedMinor",
          "acceptedOutstandingMinor",
          "netAfterFeesMinor",
          "profitMinor",
          "availability",
          "unavailableReasons"
        ],
        "properties": {
          "assoc": {
            "type": "string"
          },
          "currency": {
            "type": "string",
            "pattern": "^[a-z]{3}$"
          },
          "registrationCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "acceptedRegistrationCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "acceptedCommitmentMinor": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "completedPaymentCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "completedAmountMinor": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "recordedRefundedPaymentCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "recordedRefundedAmountMinor": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "pendingRefundPaymentCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "pendingRefundAmountMinor": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "unresolvedAttemptCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "unresolvedAttemptAmountMinor": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "inKindPaymentCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "inKindNominalAmountMinor": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "importedCompletedPaymentCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "retainedRecordedMinor": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true
          },
          "acceptedOutstandingMinor": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true
          },
          "netAfterFeesMinor": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true
          },
          "profitMinor": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991,
            "nullable": true,
            "enum": [
              null
            ]
          },
          "availability": {
            "type": "string",
            "enum": [
              "QUALIFIED",
              "RECORDED_AMOUNTS_AVAILABLE"
            ]
          },
          "unavailableReasons": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "REFUND_RESULT_UNCONFIRMED",
                "PAYMENT_RESULT_UNCONFIRMED",
                "NON_MONETARY_PAYMENT",
                "FEE_CURRENCY_UNPROVEN",
                "FEE_AMOUNT_UNAVAILABLE"
              ]
            }
          }
        }
      },
      "EventCalendarDiscoveryResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/EventCalendarDiscovery"
          }
        }
      },
      "EventCalendarDiscovery": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "url",
          "format",
          "access",
          "organisationId",
          "virtualId",
          "language",
          "readAt",
          "eventCount",
          "excludedUndated",
          "from",
          "to",
          "coverage",
          "maxEvents",
          "maxSourceRows",
          "maxCalendarBytes",
          "calendarBytes",
          "deletionMode",
          "historyAvailable"
        ],
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "URL publique d’abonnement iCalendar. Ne contient aucune clé API, aucun jeton de compte ni donnée de donateur. L’ajout de cette URL à un client de calendrier est une action distincte effectuée dans ce client."
          },
          "format": {
            "type": "string",
            "enum": [
              "ICALENDAR"
            ]
          },
          "access": {
            "type": "string",
            "enum": [
              "PUBLIC"
            ]
          },
          "organisationId": {
            "type": "string"
          },
          "virtualId": {
            "type": "string",
            "nullable": true
          },
          "language": {
            "type": "string"
          },
          "readAt": {
            "type": "string",
            "format": "date-time"
          },
          "eventCount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 5000
          },
          "excludedUndated": {
            "type": "integer",
            "minimum": 0,
            "description": "Entrées publiques courantes sans début enregistré. Elles ne peuvent pas devenir des occurrences de calendrier ; aucune heure courante ni date de journée entière n’est fabriquée."
          },
          "from": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "to": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "coverage": {
            "type": "string",
            "enum": [
              "CURRENT_PUBLIC_DATED_EVENTS"
            ]
          },
          "maxEvents": {
            "type": "integer",
            "enum": [
              5000
            ]
          },
          "maxSourceRows": {
            "type": "integer",
            "enum": [
              10000
            ]
          },
          "maxCalendarBytes": {
            "type": "integer",
            "enum": [
              8388608
            ]
          },
          "calendarBytes": {
            "type": "integer",
            "minimum": 0,
            "maximum": 8388608
          },
          "deletionMode": {
            "type": "string",
            "enum": [
              "CURRENT_SNAPSHOT"
            ]
          },
          "historyAvailable": {
            "type": "boolean",
            "enum": [
              false
            ]
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
