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

# Fundraising

OpenAPI 3.0.3 · API 2.0.0

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

## Opérations

## POST /fundraising/campaigns/{id}/ambassador-reminders/preview

Prévisualiser des relances aux ambassadeurs explicitement sélectionnés

`preview_fundraising_ambassador_reminders`

Nécessite fundraising:read ET contacts:read ; l’envoi et la lecture des commandes exigent aussi l’attribution explicite de fundraising:reminders:send. La collecte et chaque équipe doivent avoir des identifiants scalaires exacts dans l’organisation et la liste des collectes autorisées. Seules les équipes explicitement sélectionnées, approuvées, visibles, non refusées et possédant une adresse d’ambassadeur valide sont éligibles. Sélectionner 1..50 teamIds uniques ; cette sélection ne déduit ni l’historique des dons ni une audience sans don. subject et message sont du texte brut fourni par l’appelant ; le HTML est échappé à l’envoi et un lien vers l’espace personnel est ajouté. Aucun total monétaire, aucune conversion ni aucun statut de donateur n’est déduit. Aucun paramètre de requête n’est accepté. Le repos est contrôlé à l’admission en file ; le transport asynchrone et l’arrivée en boîte de réception peuvent survenir plus tard. Aperçu pur : aucun e-mail, journal, jeton privé, lien personnel ni appel prestataire n’est créé. La collecte doit actuellement être servie publiquement et LIVE selon le propriétaire canonique du cycle de vie. Renvoie les destinataires sélectionnés et le snapshot opaque à transmettre sans modification avec les mêmes teamIds, subject et message à l’envoi. Les URL d’espace personnel et les jetons privés ne sont jamais renvoyés. L’état de repos est informatif et ne bloque pas l’aperçu. Une garde durable par organisation/ressource bloque aussi une autre clé après PENDING, UNCERTAIN ou absence de preuve de clôture terminale, même après expiration du dédoublonnage natif par minute/jour. REMINDER_PREVIOUS_RESULT_UNCERTAIN exige d’observer puis de vérifier l’intention existante dans Unisoft ; ne jamais inventer une nouvelle clé ni contourner la garde. Les réservations de ressource exigent des acquittements positifs, exacts et durables d’insertion/CAS. Une preuve de clôture n’est écrite qu’après acquittement positif du journal terminal ; un simple QUEUED/UPDATED/REFUSED enregistré ne peut accorder un autre propriétaire. Une erreur accessoire de tenue de la clôture conserve l’effet positivement prouvé et maintient la garde.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "fundraising:read",
  "additional": [
    "contacts: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": {
          "teamIds": {
            "type": "array",
            "minItems": 1,
            "maxItems": 50,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{1,200}$"
            }
          },
          "subject": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "allOf": [
              {
                "pattern": "\\S"
              },
              {
                "pattern": "^[^\\r\\n]*$"
              }
            ]
          },
          "message": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2000,
            "pattern": "\\S"
          }
        },
        "required": [
          "teamIds",
          "subject",
          "message"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat observé de la relance.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingReminderPreview"
          }
        },
        "required": [
          "success",
          "data"
        ]
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_REMINDER_INPUT, EXPLICIT_REST_OVERRIDE_REQUIRED ou UNEXPECTED_REQUEST_BODY. Retirer les champs et paramètres de requête non pris en charge.",
  "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 et la configuration exigent des droits attribués explicitement.",
  "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 référence scalaire exacte requise est absente, étrangère, supprimée ou hors des collectes autorisées.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REST_TIME ou REST_STATUS_UNAVAILABLE bloque l’envoi. CAMPAIGN_NOT_LIVE, AMBASSADOR_NOT_ACTIONABLE, INVALID_AMBASSADOR_HISTORY, INVALID_REMINDER_HISTORY ou CAMPAIGN_URL_UNAVAILABLE refuse une cible indisponible. REMINDER_SNAPSHOT_CHANGED et IDEMPOTENCY_CONFLICT exigent de revoir l’intention courante. Ne jamais rejouer une commande incertaine avec une nouvelle clé.",
  "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. Un résultat inconnu n’autorise pas un nouvel envoi.",
  "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, REMINDER_QUEUE_UNCERTAIN, REMINDER_LINK_UNCERTAIN, REMINDER_TOKEN_UNCERTAIN ou REMINDER_RESERVATION_UNCERTAIN. Un acquittement durable d’écriture est absent ou contradictoire ; aucun nouvel effet ni réessai n’est autorisé. Observer la demande existante avec la même identité. REMINDER_RESOURCE_RESERVATION_UNCERTAIN n’accorde aucun propriétaire de ressource et n’autorise aucun effet ultérieur.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

### OpenAPI

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

## POST /fundraising/campaigns/{id}/ambassador-reminders/send

Mettre en file des relances aux ambassadeurs explicitement sélectionnés

`send_fundraising_ambassador_reminders`

Nécessite fundraising:read ET contacts:read ; l’envoi et la lecture des commandes exigent aussi l’attribution explicite de fundraising:reminders:send. La collecte et chaque équipe doivent avoir des identifiants scalaires exacts dans l’organisation et la liste des collectes autorisées. Seules les équipes explicitement sélectionnées, approuvées, visibles, non refusées et possédant une adresse d’ambassadeur valide sont éligibles. Sélectionner 1..50 teamIds uniques ; cette sélection ne déduit ni l’historique des dons ni une audience sans don. subject et message sont du texte brut fourni par l’appelant ; le HTML est échappé à l’envoi et un lien vers l’espace personnel est ajouté. Aucun total monétaire, aucune conversion ni aucun statut de donateur n’est déduit. Aucun paramètre de requête n’est accepté. Le repos est contrôlé à l’admission en file ; le transport asynchrone et l’arrivée en boîte de réception peuvent survenir plus tard. Prévisualiser d’abord et transmettre expectedSnapshot sans modification ; les destinataires courants, le cycle de vie de la collecte et le contenu sont de nouveau contrôlés avant les effets. Ces lectures optimistes ne sont pas une transaction avec les écritures internes. Un journal durable précède la création des jetons et l’insertion en file. Chaque lien personnel est créé seulement pendant l’envoi par le propriétaire natif des jetons d’ambassadeur et transmis uniquement au mailer ; il donne accès à l’espace privé et n’apparaît jamais dans la réponse API. La source native par jour UTC et une identité de file déterministe empêchent les doublons d’admission API ; les destinataires déjà programmés sont DUPLICATE, sans renvoi. Chabbat et Yom Tov sont bloqués par le calendrier canonique Europe/Paris. forceRest=true exige aussi restOverrideReason et une demande explicite de l’utilisateur ; ne jamais contourner REST_TIME en silence. Arrêter d’initier des destinataires après un effet incertain. Le statut de lot QUEUED signifie au moins une admission en file, avec outcomes pour les destinataires tentés ; les targetIds omis n’ont pas été initiés après interruption. PENDING ou UNCERTAIN n’autorise jamais un réessai avec une nouvelle clé. La même identité/idempotencyKey et une entrée identique relisent seulement la commande existante ; une entrée différente renvoie IDEMPOTENCY_CONFLICT. QUEUED ne signifie pas livré ; consulter la commande et les états de livraison. SMTP_ACCEPTED prouve uniquement l’acceptation prestataire ; DELIVERED exige un rapport explicite. L’API ne rejoue jamais une commande et n’interroge pas le prestataire ; le worker e-mail natif conserve sa politique de réessai de transport. Une garde durable par organisation/ressource bloque aussi une autre clé après PENDING, UNCERTAIN ou absence de preuve de clôture terminale, même après expiration du dédoublonnage natif par minute/jour. REMINDER_PREVIOUS_RESULT_UNCERTAIN exige d’observer puis de vérifier l’intention existante dans Unisoft ; ne jamais inventer une nouvelle clé ni contourner la garde. Les réservations de ressource exigent des acquittements positifs, exacts et durables d’insertion/CAS. Une preuve de clôture n’est écrite qu’après acquittement positif du journal terminal ; un simple QUEUED/UPDATED/REFUSED enregistré ne peut accorder un autre propriétaire. Une erreur accessoire de tenue de la clôture conserve l’effet positivement prouvé et maintient la garde.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "fundraising:reminders:send",
  "additional": [
    "fundraising:read",
    "contacts: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": {
        "$ref": "#/components/schemas/UnisoftRequest_4cc8ff458f9ad2b34bcf"
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Résultat observé de la relance.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingReminderCommand"
          }
        },
        "required": [
          "success",
          "data"
        ]
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_REMINDER_INPUT, EXPLICIT_REST_OVERRIDE_REQUIRED ou UNEXPECTED_REQUEST_BODY. Retirer les champs et paramètres de requête non pris en charge.",
  "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 et la configuration exigent des droits attribués explicitement.",
  "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 référence scalaire exacte requise est absente, étrangère, supprimée ou hors des collectes autorisées.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REST_TIME ou REST_STATUS_UNAVAILABLE bloque l’envoi. CAMPAIGN_NOT_LIVE, AMBASSADOR_NOT_ACTIONABLE, INVALID_AMBASSADOR_HISTORY, INVALID_REMINDER_HISTORY ou CAMPAIGN_URL_UNAVAILABLE refuse une cible indisponible. REMINDER_SNAPSHOT_CHANGED et IDEMPOTENCY_CONFLICT exigent de revoir l’intention courante. Ne jamais rejouer une commande incertaine avec une nouvelle clé.",
  "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. Un résultat inconnu n’autorise pas un nouvel envoi.",
  "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, REMINDER_QUEUE_UNCERTAIN, REMINDER_LINK_UNCERTAIN, REMINDER_TOKEN_UNCERTAIN ou REMINDER_RESERVATION_UNCERTAIN. Un acquittement durable d’écriture est absent ou contradictoire ; aucun nouvel effet ni réessai n’est autorisé. Observer la demande existante avec la même identité. REMINDER_RESOURCE_RESERVATION_UNCERTAIN n’accorde aucun propriétaire de ressource et n’autorise aucun effet ultérieur.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

### OpenAPI

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

## GET /fundraising/campaigns/{id}/ambassador-reminders/commands/{requestId}

Observer un lot de relances aux ambassadeurs sans le rejouer

`get_fundraising_ambassador_reminder_command`

Nécessite fundraising:read ET contacts:read ; l’envoi et la lecture des commandes exigent aussi l’attribution explicite de fundraising:reminders:send. La collecte et chaque équipe doivent avoir des identifiants scalaires exacts dans l’organisation et la liste des collectes autorisées. Seules les équipes explicitement sélectionnées, approuvées, visibles, non refusées et possédant une adresse d’ambassadeur valide sont éligibles. Sélectionner 1..50 teamIds uniques ; cette sélection ne déduit ni l’historique des dons ni une audience sans don. subject et message sont du texte brut fourni par l’appelant ; le HTML est échappé à l’envoi et un lien vers l’espace personnel est ajouté. Aucun total monétaire, aucune conversion ni aucun statut de donateur n’est déduit. Aucun paramètre de requête n’est accepté. Le repos est contrôlé à l’admission en file ; le transport asynchrone et l’arrivée en boîte de réception peuvent survenir plus tard. Observation en lecture seule, limitée à l’identité API initiatrice et à la collecte. La lecture reste disponible après la fermeture de la collecte tant que les droits d’organisation/collecte sur les cibles restent valables. outcomes décrit les admissions en file tentées ; deliveries relit indépendamment la file persistée. QUEUED_OR_IN_FLIGHT signifie en attente ou traité par un worker actif, SMTP_ACCEPTED prouve seulement l’acceptation prestataire, et DELIVERED exige un rapport explicite. PENDING, UNCERTAIN, UNKNOWN ou deliveryRead=UNAVAILABLE n’autorise jamais un renvoi. Aucune création de jeton, invocation du mailer, tentative ni requête prestataire n’est effectuée. Une garde durable par organisation/ressource bloque aussi une autre clé après PENDING, UNCERTAIN ou absence de preuve de clôture terminale, même après expiration du dédoublonnage natif par minute/jour. REMINDER_PREVIOUS_RESULT_UNCERTAIN exige d’observer puis de vérifier l’intention existante dans Unisoft ; ne jamais inventer une nouvelle clé ni contourner la garde. Les réservations de ressource exigent des acquittements positifs, exacts et durables d’insertion/CAS. Une preuve de clôture n’est écrite qu’après acquittement positif du journal terminal ; un simple QUEUED/UPDATED/REFUSED enregistré ne peut accorder un autre propriétaire. Une erreur accessoire de tenue de la clôture conserve l’effet positivement prouvé et maintient la garde.

### Authentification

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

### Permissions requises

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

### 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": "Résultat observé de la relance.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/FundraisingReminderCommand"
          }
        },
        "required": [
          "success",
          "data"
        ]
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_UUID, INVALID_REMINDER_INPUT, EXPLICIT_REST_OVERRIDE_REQUIRED ou UNEXPECTED_REQUEST_BODY. Retirer les champs et paramètres de requête non pris en charge.",
  "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 et la configuration exigent des droits attribués explicitement.",
  "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 référence scalaire exacte requise est absente, étrangère, supprimée ou hors des collectes autorisées.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "REST_TIME ou REST_STATUS_UNAVAILABLE bloque l’envoi. CAMPAIGN_NOT_LIVE, AMBASSADOR_NOT_ACTIONABLE, INVALID_AMBASSADOR_HISTORY, INVALID_REMINDER_HISTORY ou CAMPAIGN_URL_UNAVAILABLE refuse une cible indisponible. REMINDER_SNAPSHOT_CHANGED et IDEMPOTENCY_CONFLICT exigent de revoir l’intention courante. Ne jamais rejouer une commande incertaine avec une nouvelle clé.",
  "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. Un résultat inconnu n’autorise pas un nouvel envoi.",
  "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, REMINDER_QUEUE_UNCERTAIN, REMINDER_LINK_UNCERTAIN, REMINDER_TOKEN_UNCERTAIN ou REMINDER_RESERVATION_UNCERTAIN. Un acquittement durable d’écriture est absent ou contradictoire ; aucun nouvel effet ni réessai n’est autorisé. Observer la demande existante avec la même identité. REMINDER_RESOURCE_RESERVATION_UNCERTAIN n’accorde aucun propriétaire de ressource et n’autorise aucun effet ultérieur.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        },
        "required": [
          "success",
          "error"
        ]
      }
    }
  }
}
```

### OpenAPI

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

## Schémas

```json
{
  "components": {
    "schemas": {
      "FundraisingReminderPreview": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "campaignId": {
            "type": "string",
            "format": "uuid"
          },
          "snapshot": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "channel": {
            "type": "string",
            "enum": [
              "EMAIL"
            ]
          },
          "subject": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "targets": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "teamId": {
                  "type": "string"
                },
                "label": {
                  "type": "string",
                  "nullable": true
                },
                "email": {
                  "type": "string"
                }
              },
              "required": [
                "teamId",
                "label",
                "email"
              ]
            }
          },
          "personalLink": {
            "type": "string",
            "enum": [
              "CREATED_ONLY_ON_SEND"
            ]
          },
          "selection": {
            "type": "string",
            "enum": [
              "EXPLICIT_TEAM_IDS"
            ]
          },
          "rest": {
            "$ref": "#/components/schemas/PledgeReminderRest"
          }
        },
        "required": [
          "campaignId",
          "snapshot",
          "channel",
          "subject",
          "message",
          "targets",
          "personalLink",
          "selection",
          "rest"
        ]
      },
      "PledgeReminderRest": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "blocked": {
            "type": "boolean"
          },
          "reason": {
            "type": "string",
            "nullable": true
          },
          "until": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "timeZone": {
            "type": "string",
            "enum": [
              "Europe/Paris"
            ]
          }
        },
        "required": [
          "blocked",
          "reason",
          "until",
          "timeZone"
        ]
      },
      "UnisoftRequest_4cc8ff458f9ad2b34bcf": {
        "type": "object",
        "properties": {
          "teamIds": {
            "type": "array",
            "minItems": 1,
            "maxItems": 50,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{1,200}$"
            }
          },
          "subject": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "allOf": [
              {
                "pattern": "\\S"
              },
              {
                "pattern": "^[^\\r\\n]*$"
              }
            ]
          },
          "message": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2000,
            "pattern": "\\S"
          },
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedSnapshot": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "forceRest": {
            "type": "boolean"
          },
          "restOverrideReason": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500,
            "pattern": "\\S"
          }
        },
        "required": [
          "teamIds",
          "subject",
          "message",
          "idempotencyKey",
          "expectedSnapshot"
        ],
        "additionalProperties": false,
        "oneOf": [
          {
            "type": "object",
            "properties": {
              "forceRest": {
                "type": "boolean",
                "enum": [
                  true
                ]
              }
            },
            "required": [
              "forceRest",
              "restOverrideReason"
            ],
            "additionalProperties": true
          },
          {
            "type": "object",
            "properties": {
              "forceRest": {
                "type": "boolean",
                "enum": [
                  false
                ]
              }
            },
            "additionalProperties": true,
            "not": {
              "required": [
                "restOverrideReason"
              ]
            }
          }
        ]
      },
      "FundraisingReminderCommand": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "requestId": {
            "type": "string",
            "format": "uuid"
          },
          "action": {
            "type": "string",
            "enum": [
              "SEND",
              "RULES"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "PENDING",
              "QUEUED",
              "UPDATED",
              "REFUSED",
              "UNCERTAIN"
            ]
          },
          "requestedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "completedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "targetIds": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string"
            }
          },
          "error": {
            "type": "string",
            "nullable": true
          },
          "outcomes": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "targetId": {
                  "type": "string"
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "QUEUED",
                    "DUPLICATE",
                    "REFUSED",
                    "UNCERTAIN"
                  ]
                }
              },
              "required": [
                "targetId",
                "status"
              ]
            }
          },
          "retryable": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "deliveryRead": {
            "type": "string",
            "enum": [
              "AVAILABLE",
              "UNAVAILABLE"
            ]
          },
          "deliveries": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "targetId": {
                  "type": "string"
                },
                "sendId": {
                  "type": "string",
                  "format": "uuid"
                },
                "state": {
                  "type": "string",
                  "enum": [
                    "QUEUED_OR_IN_FLIGHT",
                    "SMTP_ACCEPTED",
                    "DELIVERED",
                    "FAILED",
                    "CANCELED",
                    "UNCERTAIN",
                    "UNKNOWN"
                  ]
                }
              },
              "required": [
                "targetId",
                "sendId",
                "state"
              ]
            }
          },
          "campaignId": {
            "type": "string",
            "format": "uuid"
          }
        },
        "required": [
          "requestId",
          "action",
          "status",
          "requestedAt",
          "completedAt",
          "targetIds",
          "error",
          "outcomes",
          "retryable",
          "deliveryRead",
          "deliveries",
          "campaignId"
        ]
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
