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

# Catalogue de modèles d’email

OpenAPI 3.0.3 · API 2.0.0

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

Bibliothèque globale de modèles d’email conçue pour l’IA. `/email-templates/catalog*` est indépendant des organisations et accepte uniquement le jeton système dédié `kc_live_*`. `/email-templates/library*` permet à chaque organisation de parcourir les modèles publiés, de les prévisualiser avec sa propre marque et de les importer. Le jeton système est limité à `email_template_catalog:read|write|publish` et ne peut pas accéder aux données client.

## Opérations

## GET /email-templates/catalog/variables

Lister les variables d’email prises en charge

`list_email_template_variables`

Autorisation système requise : `email_template_catalog:read`. Renvoie les seules variables qu’une IA peut utiliser. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

### Authentification

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

### Permissions requises

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

### Réponses

#### HTTP 200

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

#### HTTP 403

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

### OpenAPI

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

## POST /email-templates/catalog/assets

Téléverser une image pour les emails du catalogue

`upload_catalog_email_template_asset`

Autorisation système requise : `email_template_catalog:write`. Accepte une image PNG, JPEG ou WebP en base64, valide les véritables octets de l’image et renvoie une URL HTTPS stable à utiliser dans le HTML. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

### Authentification

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

### Permissions requises

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

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "string",
            "format": "byte",
            "description": "Données d’image en base64 brut, ou URL complète data:image/...;base64,... ."
          },
          "mimeType": {
            "type": "string",
            "enum": [
              "image/png",
              "image/jpeg",
              "image/jpg",
              "image/webp"
            ]
          },
          "name": {
            "type": "string",
            "maxLength": 160
          }
        },
        "required": [
          "data"
        ],
        "additionalProperties": false,
        "description": "Téléverser une image d’email depuis une chaîne base64 brute ou une URL data. Utilisez l’URL HTTPS renvoyée dans le HTML du catalogue. Taille décodée maximale : 5 MB."
      }
    }
  }
}
```

### Réponses

#### HTTP 201

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

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

### OpenAPI

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

## GET /email-templates/catalog

Lister les brouillons du catalogue et les modèles publiés

`list_catalog_email_templates`

Autorisation système requise : `email_template_catalog:read`. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "status",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "DRAFT",
      "PUBLISHED"
    ]
  }
}
```

```json
{
  "name": "language",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "search",
  "in": "query",
  "schema": {
    "type": "string",
    "maxLength": 100
  }
}
```

### Réponses

#### HTTP 200

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

### OpenAPI

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

## POST /email-templates/catalog

Créer un brouillon complet du catalogue

`create_catalog_email_template`

Autorisation système requise : `email_template_catalog:write`. Crée ensemble le HTML et les métadonnées du catalogue, puis renvoie les résultats de validation. Le modèle reste en DRAFT jusqu’à sa publication explicite. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

### Authentification

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

### Permissions requises

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

### Corps de la requête

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

### Réponses

#### HTTP 201

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

#### 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": "CATALOG_SYSTEM_KEY_REQUIRED",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean",
            "example": false
          },
          "error": {
            "type": "string",
            "example": "CATALOG_SYSTEM_KEY_REQUIRED"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /email-templates/catalog/{id}

Obtenir un modèle du catalogue et sa validation

`get_catalog_email_template`

Autorisation système requise : `email_template_catalog:read`. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "email_template_catalog: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/EmailTemplateCatalogItem"
          }
        }
      }
    }
  }
}
```

#### 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": "email_template_catalog:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## PATCH /email-templates/catalog/{id}

Modifier les métadonnées du catalogue

`update_catalog_email_template`

Autorisation système requise : `email_template_catalog:write`. Fait repasser le modèle à l’état DRAFT. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "email_template_catalog:write",
  "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."
}
```

### Corps de la requête

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

### Réponses

#### HTTP 200

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

#### 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": "email_template_catalog:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## DELETE /email-templates/catalog/{id}

Supprimer un modèle du catalogue

`delete_catalog_email_template`

Autorisation système requise : `email_template_catalog:write`. Supprime logiquement le modèle, qu’il soit en brouillon ou publié. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "email_template_catalog:write",
  "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": {
            "type": "object"
          }
        }
      }
    }
  }
}
```

#### 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": "email_template_catalog:write",
  "x-unisoft-mcp": {
    "category": "delete",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": false
  }
}
```

## PUT /email-templates/catalog/{id}/content

Remplacer le HTML du catalogue

`update_catalog_email_template_content`

Autorisation système requise : `email_template_catalog:write`. Fait repasser le modèle à l’état DRAFT et renvoie les résultats de validation. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "email_template_catalog:write",
  "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."
}
```

### Corps de la requête

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

### Réponses

#### HTTP 200

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

#### 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": "email_template_catalog:write",
  "x-unisoft-mcp": {
    "category": "update",
    "readOnly": false,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /email-templates/catalog/{id}/validate

Valider un modèle du catalogue

`validate_catalog_email_template`

Autorisation système requise : `email_template_catalog:read`. Vérifie les métadonnées obligatoires, les variables inconnues, le lien de désinscription, le HTML non sûr et les problèmes courants de mise en page des clients de messagerie. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "email_template_catalog: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/EmailTemplateValidation"
          }
        }
      }
    }
  }
}
```

#### 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": "email_template_catalog:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /email-templates/catalog/{id}/preview-link

Créer une URL d’aperçu dans le navigateur

`create_catalog_email_template_preview_link`

Autorisation système requise : `email_template_catalog:read`. Renvoie une URL signée et l’objet/pré-en-tête rendu, valides de 1 à 60 minutes. L’aperçu de rédaction utilise une organisation synthétique sans risque et des valeurs d’exemple pour le destinataire ; la clé système ne lit donc aucune donnée client. Fonctionne pour les modèles DRAFT et PUBLISHED, y compris les brouillons comportant des erreurs de validation ou des avertissements de compatibilité. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "email_template_catalog: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."
}
```

### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "expiresInSeconds": {
            "type": "integer",
            "minimum": 60,
            "maximum": 3600,
            "default": 900
          }
        },
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

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

#### HTTP 404

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

#### HTTP 503

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

### OpenAPI

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

## POST /email-templates/catalog/{id}/publish

Publier un modèle du catalogue validé

`publish_catalog_email_template`

Autorisation système requise : `email_template_catalog:publish`. La publication est refusée si la validation contient une erreur. En cas de réussite, la version immuable du catalogue visible par les clients est incrémentée. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "email_template_catalog:publish",
  "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/EmailTemplateCatalogItem"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

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

#### HTTP 404

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

#### HTTP 409

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

### OpenAPI

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

## POST /email-templates/catalog/{id}/unpublish

Remettre un modèle du catalogue en brouillon

`unpublish_catalog_email_template`

Autorisation système requise : `email_template_catalog:publish`. Retire le modèle du catalogue client sans le supprimer. Cette opération globale accepte uniquement le jeton de catalogue dédié `kc_live_*`, sans organisation.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "email_template_catalog:publish",
  "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": {
            "type": "object"
          }
        }
      }
    }
  }
}
```

#### 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": "email_template_catalog:publish",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

## GET /email-templates/library

Parcourir les modèles d’email publiés

`list_published_email_templates`

Autorisation requise : `email_templates:read`. Accessible à toutes les organisations. Renvoie uniquement les modèles PUBLISHED et indique si la version actuelle a déjà été importée dans l’organisation de l’appelant.

### Authentification

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

### Permissions requises

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

### Paramètres

```json
{
  "name": "language",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "category",
  "in": "query",
  "schema": {
    "type": "string"
  }
}
```

```json
{
  "name": "search",
  "in": "query",
  "schema": {
    "type": "string",
    "maxLength": 100
  }
}
```

### Réponses

#### HTTP 200

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

### OpenAPI

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

## GET /email-templates/library/{id}

Obtenir un modèle d’email publié

`get_published_email_template`

Autorisation requise : `email_templates:read`. Renvoie la source publiée, y compris ses variables HTML. Utilisez l’opération de lien d’aperçu pour l’afficher avec l’identité visuelle de l’organisation actuelle.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "email_templates: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/EmailTemplateCatalogItem"
          }
        }
      }
    }
  }
}
```

#### 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": "email_templates:read",
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /email-templates/library/{id}/preview-link

Prévisualiser un modèle publié avec ma marque

`create_published_email_template_preview_link`

Autorisation requise : `email_templates:read`. Renvoie une URL de navigateur signée. L’organisation cible est toujours celle de la clé API et ne peut pas être remplacée.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "email_templates: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."
}
```

### Corps de la requête

```json
{
  "required": false,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "expiresInSeconds": {
            "type": "integer",
            "minimum": 60,
            "maximum": 3600,
            "default": 900
          }
        },
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

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

#### HTTP 404

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

#### HTTP 503

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

### OpenAPI

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

## POST /email-templates/library/{id}/import

Importer un modèle publié dans mon organisation

`import_published_email_template`

Autorisation requise : `email_templates:write`. Crée un modèle IA autonome dans l’organisation de l’appelant. Toutes les variables `{{org.*}}` sont résolues à partir de cette organisation ; les variables du destinataire restent à résoudre au moment de l’envoi. Importer deux fois la même version publiée est idempotent.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "email_templates:write",
  "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": "Déjà importé",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EmailTemplateImportResult"
      }
    }
  }
}
```

#### HTTP 201

```json
{
  "description": "Importé",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/EmailTemplateImportResult"
      }
    }
  }
}
```

#### 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": "email_templates:write",
  "x-unisoft-mcp": {
    "category": "create",
    "readOnly": false,
    "destructive": false,
    "idempotent": false,
    "warn": false
  }
}
```

## GET /email-templates/catalog/{id}/preview

Ouvrir un aperçu signé existant de modèle d’email

`preview_catalog_email_template`

Capacité HTML existante de courte durée pour navigateur, sans création ni modification du catalogue ni outil MCP. Nécessite le jeton signé exact précédemment retourné par une opération de lien d’aperçu autorisée ; une clé API d’organisation ne le remplace pas. Le jeton lie l’UUID du modèle, le contexte SAMPLE ou l’organisation cible et l’expiration. Le gestionnaire vérifie signature et concordance du modèle avant lecture, puis rend avec l’organisation liée. Une capacité invalide ou expirée retourne 401 ; un modèle ou une organisation indisponible retourne 404. Le HTML est sandboxé, avec cache privé no-store et politique no-referrer. Aucun modèle n’est édité ni publié, aucun email envoyé ni jeton renouvelé. Ne pas journaliser ni redistribuer l’URL confidentielle. Seuls id et token sont admis ; les corps GET et paramètres de requête inconnus sont refusés.

### Authentification

```json
[
  {
    "HttpAuxiliaryPreviewToken": []
  }
]
```

### Permissions requises

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

### Paramètres

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

```json
{
  "name": "token",
  "in": "query",
  "required": true,
  "schema": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]{43}$"
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Document HTML sandboxé pour le contexte d’aperçu lié au jeton.",
  "content": {
    "text/html": {
      "schema": {
        "type": "string"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "Paramètre typé, enveloppe, structure de données dynamiques ou métadonnées de fichier invalides ; ce refus n’autorise aucun effet métier."
}
```

#### HTTP 401

```json
{
  "description": "Identifiant ou capacité signée absent, invalide ou expiré."
}
```

#### HTTP 403

```json
{
  "description": "Le scope requis ou le contexte de clé d’organisation manque ; aucun remplacement d’identifiant ni repli sur une clé racine."
}
```

#### HTTP 404

```json
{
  "description": "La ressource ou dépendance est absente, étrangère, non publique ou indisponible."
}
```

#### HTTP 409

```json
{
  "description": "L’état métier enregistré ou la restriction configurée sur l’origine de retour empêche cette opération."
}
```

#### HTTP 500

```json
{
  "description": "Le propriétaire n’a pas pu terminer la demande."
}
```

### OpenAPI

```json
{
  "x-unisoft-mcp": false,
  "x-unisoft-scope": null
}
```

## Schémas

```json
{
  "components": {
    "schemas": {
      "EmailTemplateVariableCatalogue": {
        "type": "object",
        "properties": {
          "organisation": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EmailTemplateVariableDefinition"
            }
          },
          "recipient": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EmailTemplateVariableDefinition"
            }
          }
        }
      },
      "EmailTemplateVariableDefinition": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "example": "org.logoUrl"
          },
          "token": {
            "type": "string",
            "example": "{{org.logoUrl}}"
          },
          "description": {
            "type": "string"
          },
          "resolvedAt": {
            "type": "string",
            "enum": [
              "preview_and_import",
              "send"
            ]
          },
          "example": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "EmailTemplateCatalogAsset": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "filename": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "mimeType": {
            "type": "string"
          },
          "size": {
            "type": "integer"
          },
          "width": {
            "type": "integer"
          },
          "height": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "EmailTemplateCatalogItem": {
        "type": "object",
        "description": "Source globale stockée dans la collection dédiée email_template_catalog. Elle ne devient pas un modèle d’email propre à une organisation tant qu’elle n’est pas importée.",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "readOnly": true
          },
          "name": {
            "type": "string"
          },
          "editorType": {
            "type": "string",
            "enum": [
              "AI"
            ],
            "readOnly": true
          },
          "html": {
            "type": "string",
            "nullable": true
          },
          "thumbnailUrl": {
            "type": "string",
            "format": "uri",
            "nullable": true,
            "readOnly": true
          },
          "catalog": {
            "$ref": "#/components/schemas/EmailTemplateCatalogMetadata"
          },
          "datetime": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "editDatetime": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          },
          "alreadyImported": {
            "type": "boolean",
            "readOnly": true
          }
        }
      },
      "EmailTemplateCatalogMetadata": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "DRAFT",
              "PUBLISHED"
            ],
            "readOnly": true
          },
          "language": {
            "type": "string",
            "pattern": "^[a-z]{2,3}(-[a-z]{2})?$",
            "example": "fr",
            "description": "Langue du modèle. Créez un modèle par langue."
          },
          "category": {
            "type": "string",
            "maxLength": 80,
            "example": "Remerciements"
          },
          "subject": {
            "type": "string",
            "maxLength": 180,
            "description": "Objet d’email suggéré ; les variables de l’organisation sont prises en charge."
          },
          "preheader": {
            "type": "string",
            "maxLength": 240,
            "description": "Texte d’aperçu facultatif de la boîte de réception ; les variables de l’organisation sont prises en charge."
          },
          "description": {
            "type": "string",
            "maxLength": 600,
            "description": "Explication destinée au client sur les cas d’utilisation de ce modèle."
          },
          "familyKey": {
            "type": "string",
            "maxLength": 100,
            "description": "Clé stable partagée par les traductions d’un même modèle, par ex. donation-thanks."
          },
          "tags": {
            "type": "array",
            "maxItems": 20,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "maxLength": 60
            }
          },
          "version": {
            "type": "integer",
            "minimum": 0,
            "readOnly": true
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "publishedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          }
        }
      },
      "UnisoftRequest_a3f7f9c0ed11437f4db4": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 160,
            "description": "Nom interne du catalogue."
          },
          "html": {
            "type": "string",
            "maxLength": 2000000,
            "description": "Email HTML complet. Respectez toutes les règles de compatibilité des clients de messagerie et d’utilisation des variables ci-dessus."
          },
          "language": {
            "type": "string",
            "pattern": "^[a-z]{2,3}(-[a-z]{2})?$",
            "description": "Langue du modèle. Créez un modèle par langue.",
            "example": "fr"
          },
          "category": {
            "type": "string",
            "maxLength": 80,
            "example": "Remerciements"
          },
          "subject": {
            "type": "string",
            "maxLength": 180,
            "description": "Objet d’email suggéré ; les variables de l’organisation sont prises en charge."
          },
          "preheader": {
            "type": "string",
            "maxLength": 240,
            "description": "Texte d’aperçu facultatif de la boîte de réception ; les variables de l’organisation sont prises en charge."
          },
          "description": {
            "type": "string",
            "maxLength": 600,
            "description": "Explication destinée au client sur les cas d’utilisation de ce modèle."
          },
          "familyKey": {
            "type": "string",
            "maxLength": 100,
            "description": "Clé stable partagée par les traductions d’un même modèle, par ex. donation-thanks."
          },
          "tags": {
            "type": "array",
            "maxItems": 20,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "maxLength": 60
            }
          }
        },
        "required": [
          "name",
          "html",
          "language",
          "category",
          "subject"
        ],
        "additionalProperties": false,
        "description": "Créer un brouillon complet du catalogue en un seul appel.\n\nRègles de compatibilité des clients de messagerie :\n- Envoyez un document HTML UTF-8 COMPLET avec `<!doctype html>`, `<html>`, `<head>` et `<body>`.\n- Construisez la mise en page avec des tableaux de présentation (`<table role=\"presentation\">`, `<tr>`, `<td>`), jamais avec flexbox ou CSS grid.\n- Limitez l’email principal à 600px de largeur et centrez-le sur un arrière-plan pleine largeur neutre.\n- Placez les styles essentiels en ligne. Ne dépendez pas des classes CSS, polices web, feuilles de style externes, images d’arrière-plan ou effets de survol ; Outlook et certains webmails les suppriment.\n- Attribuez à chaque `<img>` des attributs HTML `width` et `height` numériques explicites, un texte `alt` pertinent et une source HTTPS sûre ou `{{org.logoUrl}}`.\n- Utilisez uniquement Arial, Helvetica et sans-serif pour le texte essentiel.\n- Incluez un pré-en-tête masqué, un en-tête de marque, un corps lisible et un pied de page légal contenant `{{mailing_unsubscribe}}`.\n- N’incluez jamais de scripts, gestionnaires d’événements, iframes, formulaires, objets, embeds ou URL `javascript:`.\n- Un brouillon peut toujours être prévisualisé. Avant publication, appelez la validation et corrigez chaque erreur et avertissement de compatibilité pour un résultat plus fiable sur Gmail/Apple Mail/Outlook.\n\nRègles relatives aux variables :\n- Utilisez uniquement les variables renvoyées par `list_email_template_variables`.\n- Les variables d’organisation utilisent une marque d’exemple sans risque dans l’aperçu de rédaction, puis sont résolues selon l’organisation cliente authentifiée lors de l’aperçu/de l’importation client.\n- Les variables du destinataire `{{firstname}}`, `{{lastname}}`, `{{hebrewname}}` et `{{mailing_unsubscribe}}` doivent rester dans le HTML stocké ; elles sont résolues uniquement à l’envoi de l’email. Les alias historiques `{{prenom}}`, `{{nom}}` et `{{prenomHE}}` restent pris en charge ; privilégiez les jetons canoniques dans les nouveaux modèles.\n- `{{mailing_unsubscribe}}` est obligatoire dans le pied de page.\n- Ne collez jamais le nom, l’URL du logo, l’adresse, le téléphone ou le site web réels d’un client dans un modèle central."
      },
      "UnisoftRequest_133d3d8dfbcc7c041b4c": {
        "type": "object",
        "minProperties": 1,
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 160
          },
          "language": {
            "type": "string",
            "pattern": "^[a-z]{2,3}(-[a-z]{2})?$",
            "description": "Langue du modèle. Créez un modèle par langue.",
            "example": "fr"
          },
          "category": {
            "type": "string",
            "maxLength": 80,
            "example": "Remerciements"
          },
          "subject": {
            "type": "string",
            "maxLength": 180,
            "description": "Objet d’email suggéré ; les variables de l’organisation sont prises en charge."
          },
          "preheader": {
            "type": "string",
            "maxLength": 240,
            "description": "Texte d’aperçu facultatif de la boîte de réception ; les variables de l’organisation sont prises en charge."
          },
          "description": {
            "type": "string",
            "maxLength": 600,
            "description": "Explication destinée au client sur les cas d’utilisation de ce modèle."
          },
          "familyKey": {
            "type": "string",
            "maxLength": 100,
            "description": "Clé stable partagée par les traductions d’un même modèle, par ex. donation-thanks."
          },
          "tags": {
            "type": "array",
            "maxItems": 20,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "maxLength": 60
            }
          }
        },
        "additionalProperties": false,
        "description": "Mettre à jour les métadonnées du catalogue. Toute mise à jour fait repasser un modèle publié à l’état DRAFT ; publiez-le à nouveau après validation."
      },
      "UnisoftRequest_3e69fa09dc71af9ca38e": {
        "type": "object",
        "properties": {
          "html": {
            "type": "string",
            "maxLength": 2000000
          }
        },
        "required": [
          "html"
        ],
        "additionalProperties": false,
        "description": "Remplacer l’intégralité du HTML et faire repasser le modèle à l’état DRAFT.\n\nRègles de compatibilité des clients de messagerie :\n- Envoyez un document HTML UTF-8 COMPLET avec `<!doctype html>`, `<html>`, `<head>` et `<body>`.\n- Construisez la mise en page avec des tableaux de présentation (`<table role=\"presentation\">`, `<tr>`, `<td>`), jamais avec flexbox ou CSS grid.\n- Limitez l’email principal à 600px de largeur et centrez-le sur un arrière-plan pleine largeur neutre.\n- Placez les styles essentiels en ligne. Ne dépendez pas des classes CSS, polices web, feuilles de style externes, images d’arrière-plan ou effets de survol ; Outlook et certains webmails les suppriment.\n- Attribuez à chaque `<img>` des attributs HTML `width` et `height` numériques explicites, un texte `alt` pertinent et une source HTTPS sûre ou `{{org.logoUrl}}`.\n- Utilisez uniquement Arial, Helvetica et sans-serif pour le texte essentiel.\n- Incluez un pré-en-tête masqué, un en-tête de marque, un corps lisible et un pied de page légal contenant `{{mailing_unsubscribe}}`.\n- N’incluez jamais de scripts, gestionnaires d’événements, iframes, formulaires, objets, embeds ou URL `javascript:`.\n- Un brouillon peut toujours être prévisualisé. Avant publication, appelez la validation et corrigez chaque erreur et avertissement de compatibilité pour un résultat plus fiable sur Gmail/Apple Mail/Outlook.\n\nRègles relatives aux variables :\n- Utilisez uniquement les variables renvoyées par `list_email_template_variables`.\n- Les variables d’organisation utilisent une marque d’exemple sans risque dans l’aperçu de rédaction, puis sont résolues selon l’organisation cliente authentifiée lors de l’aperçu/de l’importation client.\n- Les variables du destinataire `{{firstname}}`, `{{lastname}}`, `{{hebrewname}}` et `{{mailing_unsubscribe}}` doivent rester dans le HTML stocké ; elles sont résolues uniquement à l’envoi de l’email. Les alias historiques `{{prenom}}`, `{{nom}}` et `{{prenomHE}}` restent pris en charge ; privilégiez les jetons canoniques dans les nouveaux modèles.\n- `{{mailing_unsubscribe}}` est obligatoire dans le pied de page.\n- Ne collez jamais le nom, l’URL du logo, l’adresse, le téléphone ou le site web réels d’un client dans un modèle central."
      },
      "EmailTemplateValidation": {
        "type": "object",
        "properties": {
          "valid": {
            "type": "boolean"
          },
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EmailTemplateValidationIssue"
            }
          },
          "warnings": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EmailTemplateValidationIssue"
            }
          },
          "variables": {
            "type": "object",
            "properties": {
              "used": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "organisation": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "recipient": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "unknown": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "EmailTemplateValidationIssue": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "variables": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "EmailTemplatePreviewLink": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "URL signée de courte durée, ouvrable directement dans un navigateur sans en-têtes API."
          },
          "expiresAt": {
            "type": "string",
            "format": "date-time"
          },
          "previewContext": {
            "type": "string",
            "enum": [
              "SAMPLE",
              "ORGANISATION"
            ]
          },
          "targetOrganisationId": {
            "type": "string",
            "nullable": true
          },
          "subject": {
            "type": "string",
            "description": "Objet affiché avec l’organisation cible dans l’aperçu d’une bibliothèque cliente."
          },
          "preheader": {
            "type": "string",
            "description": "Pré-en-tête affiché avec l’organisation cible dans l’aperçu d’une bibliothèque cliente."
          }
        }
      },
      "EmailTemplateImportResult": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/EmailTemplate"
          },
          "alreadyImported": {
            "type": "boolean",
            "description": "true si cette version publiée précise avait déjà été importée ; aucun doublon n’a été créé."
          }
        }
      },
      "EmailTemplate": {
        "type": "object",
        "description": "Modèle HTML d’email réutilisable (collection email_templates). Email HTML complet réutilisable par une organisation — par ex. associé à une campagne comme email de remerciement au donateur (`campagnes.config.donorEmailTemplate`). `design`/`assets` sont les structures internes de l’éditeur (exposées en lecture seule).",
        "properties": {
          "id": {
            "type": "string"
          },
          "organisation": {
            "type": "string"
          },
          "name": {
            "type": "string",
            "description": "Nom d’affichage du modèle."
          },
          "editorType": {
            "type": "string",
            "enum": [
              "EDITOR",
              "AI"
            ],
            "description": "Éditeur utilisé : EDITOR (éditeur visuel, stocke `design`) ou AI (éditeur IA, stocke `assets`)."
          },
          "html": {
            "type": "string",
            "nullable": true,
            "description": "Email HTML complet."
          },
          "design": {
            "type": "object",
            "nullable": true,
            "readOnly": true,
            "description": "Sérialisation de l’éditeur visuel (lecture seule ; modèles EDITOR uniquement).",
            "additionalProperties": true
          },
          "assets": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "readOnly": true,
            "description": "Identifiants de ressources intégrés par l’éditeur IA (lecture seule)."
          },
          "thumbnailUrl": {
            "type": "string",
            "format": "uri",
            "nullable": true,
            "readOnly": true,
            "description": "URL publique de l’aperçu PNG généré automatiquement (au mieux ; null s’il n’a pas été généré)."
          },
          "previewUrl": {
            "type": "string",
            "format": "uri",
            "nullable": true,
            "readOnly": true,
            "description": "Lien stable et partageable vers l’aperçu du dernier HTML enregistré, avec des données d’exemple. Toute personne qui possède le lien peut l’ouvrir sans se connecter."
          },
          "datetime": {
            "type": "string",
            "format": "date-time",
            "readOnly": true
          },
          "editDatetime": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "readOnly": true
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      },
      "HttpAuxiliaryPreviewToken": {
        "type": "apiKey",
        "in": "query",
        "name": "token",
        "description": "Capacité signée de courte durée d’aperçu d’email, émise par une opération de lien d’aperçu autorisée et liée à un modèle et à son contexte de rendu. Ce n’est pas une clé API d’organisation et elle ne permet ni création, ni modification, ni publication de modèle."
      }
    }
  }
}
```
