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

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

# Cagnottes

OpenAPI 3.0.3 · API 1.0.0

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

Cagnottes de dons : pages publiques avec objectif facultatif, où les donateurs peuvent effectuer des paiements. CRUD complet et cycle de vie. Autorisations : `caisses:read`/`caisses:write`. Pour recevoir un paiement dans une cagnotte, utilisez POST /paiements avec config.type="CAISSE".

## Opérations

## GET /caisses

Lister les cagnottes

`list_caisses`

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

### Authentification

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

### Permissions requises

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

### Paramètres

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

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

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

### Réponses

#### HTTP 200

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

#### HTTP 401

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

#### HTTP 403

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

### OpenAPI

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

## POST /caisses

Créer une cagnotte

`create_caisse`

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

### Authentification

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

### Permissions requises

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

### Corps de la requête

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

### Réponses

#### HTTP 200

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

#### HTTP 400

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

#### HTTP 403

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

### OpenAPI

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

## GET /caisses/{id}

Obtenir une cagnotte

`get_caisse`

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

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Réponses

#### HTTP 200

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

#### HTTP 404

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

### OpenAPI

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

## PATCH /caisses/{id}

Modifier une cagnotte

`update_caisse`

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

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Corps de la requête

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

### Réponses

#### HTTP 200

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

#### HTTP 400

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

#### HTTP 404

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

### OpenAPI

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

## POST /caisses/{id}/pause

Mettre une cagnotte en pause

`pause_caisse`

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

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Réponses

#### HTTP 200

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

#### HTTP 404

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

### OpenAPI

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

## POST /caisses/{id}/resume

Reprendre une cagnotte en pause

`resume_caisse`

Autorisation requise : `caisses:write`.

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Réponses

#### HTTP 200

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

#### HTTP 404

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

### OpenAPI

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

## POST /caisses/{id}/archive

Archiver une cagnotte

`archive_caisse`

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

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Réponses

#### HTTP 200

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

#### HTTP 404

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

### OpenAPI

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

## POST /caisses/{id}/unarchive

Désarchiver une cagnotte

`unarchive_caisse`

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

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Réponses

#### HTTP 200

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

#### HTTP 404

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

### OpenAPI

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

## POST /caisses/{id}/delete

Désactiver une cagnotte

`delete_caisse`

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

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Réponses

#### HTTP 200

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

#### HTTP 404

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

### OpenAPI

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

## Schémas

```json
{
  "components": {
    "parameters": {
      "LimitParam": {
        "name": "limit",
        "in": "query",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "maximum": 200,
          "default": 50
        },
        "description": "Nombre de résultats par page."
      },
      "CursorParam": {
        "name": "cursor",
        "in": "query",
        "schema": {
          "type": "string"
        },
        "description": "Curseur opaque renvoyé par la requête précédente."
      },
      "IdParam": {
        "name": "id",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uuid",
          "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
        },
        "description": "Identifiant de ressource — doit être un UUID. Un identifiant mal formé est refusé avec 400 INVALID_UUID (pas simplement 404). Besoin d’un nouvel identifiant ? Appelez GET /utils/uuid."
      }
    },
    "schemas": {
      "Caisse": {
        "type": "object",
        "description": "Une cagnotte, telle que renvoyée à la lecture, enrichie des totaux collectés.",
        "properties": {
          "id": {
            "type": "string"
          },
          "organisation": {
            "type": "string"
          },
          "name": {
            "type": "string",
            "description": "Nom public de la cagnotte."
          },
          "label": {
            "type": "string",
            "description": "Libellé interne."
          },
          "objectif": {
            "type": "number",
            "description": "Objectif de collecte en unités MAJEURES (par ex. euros)."
          },
          "withObjectif": {
            "type": "boolean",
            "description": "Indique si une barre de progression vers l’objectif est affichée."
          },
          "marge": {
            "type": "number",
            "description": "Frais/marge appliqués."
          },
          "bgimage": {
            "type": "string",
            "nullable": true,
            "description": "Image d’arrière-plan (nom de fichier hébergé)."
          },
          "assoc": {
            "type": "string",
            "description": "Identifiant de l’association juridique (\"MAIN\" ou UUID)."
          },
          "typeId": {
            "type": "string",
            "description": "Lien vers le livret/PE ; identique à l’identifiant de la cagnotte lorsqu’elle est autonome."
          },
          "active": {
            "type": "boolean"
          },
          "paused": {
            "type": "boolean"
          },
          "archived": {
            "type": "boolean"
          },
          "cerfa": {
            "type": "boolean",
            "description": "Indique si les dons versés dans cette cagnotte donnent lieu à un reçu fiscal (true par défaut)."
          },
          "url": {
            "type": "string",
            "description": "Slug personnalisé de l’URL publique de la page de la cagnotte."
          },
          "hidden": {
            "type": "boolean",
            "description": "Masquer la cagnotte des listes publiques."
          },
          "presetButtons": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Montants de don prédéfinis proposés aux donateurs."
          },
          "imagesCaroussel": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Carrousel d’images (noms de fichiers hébergés)."
          },
          "textContent": {
            "type": "string",
            "description": "Contenu enrichi de la page."
          },
          "youtubeId": {
            "type": "string",
            "description": "Identifiant de la vidéo YouTube affichée sur la page."
          },
          "aiContentBlockId": {
            "type": "string",
            "description": "Identifiant du bloc de contenu IA associé."
          },
          "pe": {
            "type": "string",
            "nullable": true,
            "description": "Identifiant de la session Parcours d'Événement à laquelle cette cagnotte est rattachée."
          },
          "payed": {
            "type": "number",
            "readOnly": true,
            "description": "Total collecté à ce jour (calculé)."
          },
          "reste": {
            "type": "number",
            "readOnly": true,
            "description": "Montant restant pour atteindre l’objectif (calculé)."
          },
          "datetime": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "Pagination": {
        "type": "object",
        "properties": {
          "nextCursor": {
            "type": "string",
            "nullable": true
          },
          "hasMore": {
            "type": "boolean"
          },
          "count": {
            "type": "integer"
          }
        }
      },
      "CaisseInput": {
        "type": "object",
        "description": "Données pour créer ou modifier une cagnotte. Avec un PATCH partiel, seuls les champs fournis sont modifiés.",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Nom public de la cagnotte (obligatoire à la création)."
          },
          "label": {
            "type": "string",
            "description": "Libellé interne (nom par défaut)."
          },
          "objectif": {
            "type": "number",
            "description": "Objectif de collecte en unités MAJEURES (par ex. euros)."
          },
          "withObjectif": {
            "type": "boolean",
            "description": "Afficher une barre de progression vers l’objectif."
          },
          "marge": {
            "type": "number",
            "description": "Frais/marge appliqués (0 par défaut)."
          },
          "bgimage": {
            "type": "string",
            "description": "Image d’arrière-plan : URL http(s) (réhébergée côté serveur) ou nom de fichier déjà hébergé."
          },
          "assoc": {
            "type": "string",
            "description": "Identifiant de l’association juridique (\"MAIN\" par défaut)."
          },
          "typeId": {
            "type": "string",
            "description": "Identifiant du livret/PE auquel rattacher la cagnotte, ou \"AUTO\" pour une cagnotte autonome (rattachée à elle-même)."
          },
          "cerfa": {
            "type": "boolean",
            "description": "Indique si les dons versés dans cette cagnotte donnent lieu à un reçu fiscal (true par défaut)."
          },
          "url": {
            "type": "string",
            "description": "Slug personnalisé de l’URL publique de la page de la cagnotte."
          },
          "hidden": {
            "type": "boolean",
            "description": "Masquer la cagnotte des listes publiques."
          },
          "presetButtons": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Montants de don prédéfinis proposés aux donateurs."
          },
          "imagesCaroussel": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Carrousel d’images : chaque entrée est une URL http(s) (réhébergée) ou un nom de fichier déjà hébergé."
          },
          "textContent": {
            "type": "string",
            "description": "Contenu enrichi de la page."
          },
          "youtubeId": {
            "type": "string",
            "description": "Identifiant de la vidéo YouTube affichée sur la page."
          },
          "aiContentBlockId": {
            "type": "string",
            "description": "Identifiant du bloc de contenu IA associé."
          },
          "pe": {
            "type": "string",
            "description": "Identifiant de session Parcours d'Événement auquel rattacher cette cagnotte."
          }
        }
      },
      "CaisseUpdateInput": {
        "type": "object",
        "description": "Mise à jour partielle de cagnotte. Seuls les champs fournis sont modifiés ; aucun champ n’est obligatoire.",
        "properties": {
          "name": {
            "type": "string",
            "description": "Nom public de la cagnotte (obligatoire à la création)."
          },
          "label": {
            "type": "string",
            "description": "Libellé interne (nom par défaut)."
          },
          "objectif": {
            "type": "number",
            "description": "Objectif de collecte en unités MAJEURES (par ex. euros)."
          },
          "withObjectif": {
            "type": "boolean",
            "description": "Afficher une barre de progression vers l’objectif."
          },
          "marge": {
            "type": "number",
            "description": "Frais/marge appliqués (0 par défaut)."
          },
          "bgimage": {
            "type": "string",
            "description": "Image d’arrière-plan : URL http(s) (réhébergée côté serveur) ou nom de fichier déjà hébergé."
          },
          "assoc": {
            "type": "string",
            "description": "Identifiant de l’association juridique (\"MAIN\" par défaut)."
          },
          "typeId": {
            "type": "string",
            "description": "Identifiant du livret/PE auquel rattacher la cagnotte, ou \"AUTO\" pour une cagnotte autonome (rattachée à elle-même)."
          },
          "cerfa": {
            "type": "boolean",
            "description": "Indique si les dons versés dans cette cagnotte donnent lieu à un reçu fiscal (true par défaut)."
          },
          "url": {
            "type": "string",
            "description": "Slug personnalisé de l’URL publique de la page de la cagnotte."
          },
          "hidden": {
            "type": "boolean",
            "description": "Masquer la cagnotte des listes publiques."
          },
          "presetButtons": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Montants de don prédéfinis proposés aux donateurs."
          },
          "imagesCaroussel": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Carrousel d’images : chaque entrée est une URL http(s) (réhébergée) ou un nom de fichier déjà hébergé."
          },
          "textContent": {
            "type": "string",
            "description": "Contenu enrichi de la page."
          },
          "youtubeId": {
            "type": "string",
            "description": "Identifiant de la vidéo YouTube affichée sur la page."
          },
          "aiContentBlockId": {
            "type": "string",
            "description": "Identifiant du bloc de contenu IA associé."
          },
          "pe": {
            "type": "string",
            "description": "Identifiant de session Parcours d'Événement auquel rattacher cette cagnotte."
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
