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

# Notification Templates

OpenAPI 3.0.3 · API 2.0.0

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

## Opérations

## POST /notification-templates/templates/{id}/preview

Prévisualiser un modèle email d’organisation avec des variables d’exemple

`preview_organisation_notification_template`

email_templates:read est requis. Aperçu POST pur d’un modèle email d’organisation existant et non supprimé ; aucune recherche contact, envoi, queue, miniature, récupération prestataire ni écriture persistante. Fournir uniquement les valeurs d’exemple utilisées par le modèle, au plus 100 chaînes de 5000 caractères ; les champs corps/requête inconnus et exemples inutilisés sont refusés. Les variables d’organisation réutilisent la carte publique canonique ; les exemples fournis peuvent les remplacer. Les substitutions HTML sont échappées en une passe, en conservant littéralement les exemples contenant des tokens de modèle. Sujet/pré-en-tête sont du texte brut. Les valeurs absentes/vides figurent dans missingVariables ; unsupportedVariables liste les tokens hors du catalogue canonique organisation/destinataire même si un exemple a été fourni. complete=true signifie que tous les tokens d’aperçu ont des valeurs non vides, pas que le modèle est prêt à l’envoi ni pris en charge en production. Un token propre à l’envoi comme mailing_unsubscribe reste manquant sans exemple ; aucun lien réel de désinscription n’est inventé. L’HTML reste un contenu non fiable, à afficher dans un bac à sable sans récupération de ressources embarquées. Aucun identifiant SMTP, objet brut d’organisation ni identité destinataire n’est retourné. La révision identifie le contenu enregistré, pas une autorisation d’envoi. Les modèles absents, supprimés, étrangers, ambigus ou mal formés sont refusés ; les clés limitées aux collectes ne peuvent pas utiliser cette surface de modèles d’organisation.

### Authentification

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

### Permissions requises

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

### 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": {
          "values": {
            "type": "object",
            "maxProperties": 100,
            "additionalProperties": {
              "type": "string",
              "maxLength": 5000
            }
          }
        },
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Aperçu ou observation/acquittement de réglage limité aux champs autorisés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/NotificationTemplatePreviewResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID, type de notification, requête/corps ou valeurs d’exemple invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

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

#### HTTP 404

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

#### HTTP 409

```json
{
  "description": "Modèle/réglages enregistrés invalides, expéditeur indisponible, SYSTEM_TEMPLATE_FIXED, NOTIFICATION_SETTINGS_NOT_INITIALISED, NOTIFICATION_REVISION_CHANGED ou IDEMPOTENCY_CONFLICT. Aucun réglage non pris en charge n’est modifié.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "NOTIFICATION_TEMPLATE_UNAVAILABLE. Ne pas déduire l’échec d’une écriture de réglage incertaine.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /notification-templates/settings/BIRTHDAY/organisation

Consulter les réglages de modèle et d’expéditeur BIRTHDAY

`get_birthday_notification_settings`

Le droit explicite notification_settings:read et messages:read pour la référence d’expéditeur sont requis. Les rappels exigent aussi transactional_reminders:read ; les formulaires exigent forms:read ET email_templates:read. Les types d’organisation BIRTHDAY et HAZKARA utilisent id=organisation et un modèle système natif fixe : templateMutable=false ; choisir un modèle d’organisation n’est pas pris en charge. FORM_SUBMITTED et FORM_ACCEPTED utilisent l’UUID d’un formulaire existant. Leur templateId facultatif désigne un email d’organisation SUPPLÉMENTAIRE envoyé à côté de la confirmation système fixe, jamais un remplacement ; templateMode=SYSTEM_PLUS_ORGANISATION l’indique. templateId=null signifie absence d’email d’organisation supplémentaire, pas absence de notification système. emailConfig sélectionne le réglage natif d’expéditeur de ces notifications ; null conserve le repli natif à l’exécution et ne prouve pas un expéditeur particulier ni une configuration SMTP valide. Toutes les références formulaire/modèle/expéditeur sont réadmises indépendamment dans l’organisation ; les clés limitées à des collectes sont refusées. Aucun secret, hôte/utilisateur/mot de passe SMTP, réponse prestataire ni donnée contact n’est retourné. settingsInitialised=false signifie absence du document natif reminderEmailSenders : la lecture rapporte le repli en mémoire sans l’initialiser ; une modification exige l’initialisation dans l’application propriétaire faute de propriétaire natif unique d’upsert/CAS disponible ici. La couverture reste partielle : remerciements de collecte, échecs d’abonnement et autres familles ne sont pas exposés par cette tranche. Lire les réglages n’envoie aucun message, n’initialise aucun état persistant et n’appelle aucun prestataire.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "notification_settings:read",
  "additional": [
    "messages:read",
    "transactional_reminders:read"
  ]
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Aperçu ou observation/acquittement de réglage limité aux champs autorisés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/NotificationSettingsResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID, type de notification, requête/corps ou valeurs d’exemple invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

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

#### HTTP 404

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

#### HTTP 409

```json
{
  "description": "Modèle/réglages enregistrés invalides, expéditeur indisponible, SYSTEM_TEMPLATE_FIXED, NOTIFICATION_SETTINGS_NOT_INITIALISED, NOTIFICATION_REVISION_CHANGED ou IDEMPOTENCY_CONFLICT. Aucun réglage non pris en charge n’est modifié.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "NOTIFICATION_TEMPLATE_UNAVAILABLE. Ne pas déduire l’échec d’une écriture de réglage incertaine.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## PATCH /notification-templates/settings/BIRTHDAY/organisation

Modifier les réglages de modèle ou d’expéditeur BIRTHDAY

`update_birthday_notification_settings`

Le droit explicite notification_settings:read et messages:read pour la référence d’expéditeur sont requis. Les rappels exigent aussi transactional_reminders:read ; les formulaires exigent forms:read ET email_templates:read. Les types d’organisation BIRTHDAY et HAZKARA utilisent id=organisation et un modèle système natif fixe : templateMutable=false ; choisir un modèle d’organisation n’est pas pris en charge. FORM_SUBMITTED et FORM_ACCEPTED utilisent l’UUID d’un formulaire existant. Leur templateId facultatif désigne un email d’organisation SUPPLÉMENTAIRE envoyé à côté de la confirmation système fixe, jamais un remplacement ; templateMode=SYSTEM_PLUS_ORGANISATION l’indique. templateId=null signifie absence d’email d’organisation supplémentaire, pas absence de notification système. emailConfig sélectionne le réglage natif d’expéditeur de ces notifications ; null conserve le repli natif à l’exécution et ne prouve pas un expéditeur particulier ni une configuration SMTP valide. Toutes les références formulaire/modèle/expéditeur sont réadmises indépendamment dans l’organisation ; les clés limitées à des collectes sont refusées. Aucun secret, hôte/utilisateur/mot de passe SMTP, réponse prestataire ni donnée contact n’est retourné. settingsInitialised=false signifie absence du document natif reminderEmailSenders : la lecture rapporte le repli en mémoire sans l’initialiser ; une modification exige l’initialisation dans l’application propriétaire faute de propriétaire natif unique d’upsert/CAS disponible ici. La couverture reste partielle : remerciements de collecte, échecs d’abonnement et autres familles ne sont pas exposés par cette tranche. Lire les réglages n’envoie aucun message, n’initialise aucun état persistant et n’appelle aucun prestataire. Une écriture exige aussi notification_settings:write et le droit d’écriture du domaine cible (forms:write pour les formulaires, transactional_reminders:write pour les rappels), ainsi que tous les droits de lecture indiqués. Lire d’abord la cible, puis transmettre son expectedRevision opaque et un UUID idempotencyKey avec uniquement les champs de patch demandés. templateId est accepté uniquement pour les formulaires ; null retire l’email d’organisation supplémentaire, tandis que la notification système reste fixe. emailConfig est un identifiant de configuration Email admis ou null. L’adaptateur modifie uniquement les champs natifs du formulaire ou du document reminderEmailSenders existant avec comparaison avant écriture ; il n’envoie rien, ne modifie aucune audience, n’édite pas le contenu du modèle, ne crée pas de configuration absente et ne réécrit aucun champ sans rapport. Une commande durable liée au principal et à l’organisation précède la mutation. Une clé/charge identique relit sans mutation ; une charge différente entre en conflit. SUCCEEDED acquitte le réglage ; REFUSED enregistre une course perdue de comparaison ; UNCERTAIN couvre une écriture interrompue/incertaine et n’autorise jamais de réessai automatique avec une nouvelle clé. journalRecorded=false signifie que l’acquittement durable final du journal est indisponible : la commande renvoie UNCERTAIN et ne permet jamais de rejeu automatique. Relire la cible et conserver l’incertitude ; ni une modification de réglage ni un choix de modèle ne prouve qu’une notification future sera envoyée ou livrée.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "notification_settings:write",
  "additional": [
    "notification_settings:read",
    "messages:read",
    "transactional_reminders:read",
    "transactional_reminders:write"
  ]
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "patch": {
            "type": "object",
            "minProperties": 1,
            "properties": {
              "templateId": {
                "type": "string",
                "format": "uuid",
                "nullable": true
              },
              "emailConfig": {
                "type": "string",
                "maxLength": 200,
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "expectedRevision",
          "idempotencyKey",
          "patch"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Aperçu ou observation/acquittement de réglage limité aux champs autorisés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/NotificationSettingsChangeResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID, type de notification, requête/corps ou valeurs d’exemple invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

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

#### HTTP 404

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

#### HTTP 409

```json
{
  "description": "Modèle/réglages enregistrés invalides, expéditeur indisponible, SYSTEM_TEMPLATE_FIXED, NOTIFICATION_SETTINGS_NOT_INITIALISED, NOTIFICATION_REVISION_CHANGED ou IDEMPOTENCY_CONFLICT. Aucun réglage non pris en charge n’est modifié.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "NOTIFICATION_TEMPLATE_UNAVAILABLE. Ne pas déduire l’échec d’une écriture de réglage incertaine.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /notification-templates/settings/HAZKARA/organisation

Consulter les réglages de modèle et d’expéditeur HAZKARA

`get_hazkara_notification_settings`

Le droit explicite notification_settings:read et messages:read pour la référence d’expéditeur sont requis. Les rappels exigent aussi transactional_reminders:read ; les formulaires exigent forms:read ET email_templates:read. Les types d’organisation BIRTHDAY et HAZKARA utilisent id=organisation et un modèle système natif fixe : templateMutable=false ; choisir un modèle d’organisation n’est pas pris en charge. FORM_SUBMITTED et FORM_ACCEPTED utilisent l’UUID d’un formulaire existant. Leur templateId facultatif désigne un email d’organisation SUPPLÉMENTAIRE envoyé à côté de la confirmation système fixe, jamais un remplacement ; templateMode=SYSTEM_PLUS_ORGANISATION l’indique. templateId=null signifie absence d’email d’organisation supplémentaire, pas absence de notification système. emailConfig sélectionne le réglage natif d’expéditeur de ces notifications ; null conserve le repli natif à l’exécution et ne prouve pas un expéditeur particulier ni une configuration SMTP valide. Toutes les références formulaire/modèle/expéditeur sont réadmises indépendamment dans l’organisation ; les clés limitées à des collectes sont refusées. Aucun secret, hôte/utilisateur/mot de passe SMTP, réponse prestataire ni donnée contact n’est retourné. settingsInitialised=false signifie absence du document natif reminderEmailSenders : la lecture rapporte le repli en mémoire sans l’initialiser ; une modification exige l’initialisation dans l’application propriétaire faute de propriétaire natif unique d’upsert/CAS disponible ici. La couverture reste partielle : remerciements de collecte, échecs d’abonnement et autres familles ne sont pas exposés par cette tranche. Lire les réglages n’envoie aucun message, n’initialise aucun état persistant et n’appelle aucun prestataire.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "notification_settings:read",
  "additional": [
    "messages:read",
    "transactional_reminders:read"
  ]
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Aperçu ou observation/acquittement de réglage limité aux champs autorisés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/NotificationSettingsResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID, type de notification, requête/corps ou valeurs d’exemple invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

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

#### HTTP 404

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

#### HTTP 409

```json
{
  "description": "Modèle/réglages enregistrés invalides, expéditeur indisponible, SYSTEM_TEMPLATE_FIXED, NOTIFICATION_SETTINGS_NOT_INITIALISED, NOTIFICATION_REVISION_CHANGED ou IDEMPOTENCY_CONFLICT. Aucun réglage non pris en charge n’est modifié.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "NOTIFICATION_TEMPLATE_UNAVAILABLE. Ne pas déduire l’échec d’une écriture de réglage incertaine.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## PATCH /notification-templates/settings/HAZKARA/organisation

Modifier les réglages de modèle ou d’expéditeur HAZKARA

`update_hazkara_notification_settings`

Le droit explicite notification_settings:read et messages:read pour la référence d’expéditeur sont requis. Les rappels exigent aussi transactional_reminders:read ; les formulaires exigent forms:read ET email_templates:read. Les types d’organisation BIRTHDAY et HAZKARA utilisent id=organisation et un modèle système natif fixe : templateMutable=false ; choisir un modèle d’organisation n’est pas pris en charge. FORM_SUBMITTED et FORM_ACCEPTED utilisent l’UUID d’un formulaire existant. Leur templateId facultatif désigne un email d’organisation SUPPLÉMENTAIRE envoyé à côté de la confirmation système fixe, jamais un remplacement ; templateMode=SYSTEM_PLUS_ORGANISATION l’indique. templateId=null signifie absence d’email d’organisation supplémentaire, pas absence de notification système. emailConfig sélectionne le réglage natif d’expéditeur de ces notifications ; null conserve le repli natif à l’exécution et ne prouve pas un expéditeur particulier ni une configuration SMTP valide. Toutes les références formulaire/modèle/expéditeur sont réadmises indépendamment dans l’organisation ; les clés limitées à des collectes sont refusées. Aucun secret, hôte/utilisateur/mot de passe SMTP, réponse prestataire ni donnée contact n’est retourné. settingsInitialised=false signifie absence du document natif reminderEmailSenders : la lecture rapporte le repli en mémoire sans l’initialiser ; une modification exige l’initialisation dans l’application propriétaire faute de propriétaire natif unique d’upsert/CAS disponible ici. La couverture reste partielle : remerciements de collecte, échecs d’abonnement et autres familles ne sont pas exposés par cette tranche. Lire les réglages n’envoie aucun message, n’initialise aucun état persistant et n’appelle aucun prestataire. Une écriture exige aussi notification_settings:write et le droit d’écriture du domaine cible (forms:write pour les formulaires, transactional_reminders:write pour les rappels), ainsi que tous les droits de lecture indiqués. Lire d’abord la cible, puis transmettre son expectedRevision opaque et un UUID idempotencyKey avec uniquement les champs de patch demandés. templateId est accepté uniquement pour les formulaires ; null retire l’email d’organisation supplémentaire, tandis que la notification système reste fixe. emailConfig est un identifiant de configuration Email admis ou null. L’adaptateur modifie uniquement les champs natifs du formulaire ou du document reminderEmailSenders existant avec comparaison avant écriture ; il n’envoie rien, ne modifie aucune audience, n’édite pas le contenu du modèle, ne crée pas de configuration absente et ne réécrit aucun champ sans rapport. Une commande durable liée au principal et à l’organisation précède la mutation. Une clé/charge identique relit sans mutation ; une charge différente entre en conflit. SUCCEEDED acquitte le réglage ; REFUSED enregistre une course perdue de comparaison ; UNCERTAIN couvre une écriture interrompue/incertaine et n’autorise jamais de réessai automatique avec une nouvelle clé. journalRecorded=false signifie que l’acquittement durable final du journal est indisponible : la commande renvoie UNCERTAIN et ne permet jamais de rejeu automatique. Relire la cible et conserver l’incertitude ; ni une modification de réglage ni un choix de modèle ne prouve qu’une notification future sera envoyée ou livrée.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "notification_settings:write",
  "additional": [
    "notification_settings:read",
    "messages:read",
    "transactional_reminders:read",
    "transactional_reminders:write"
  ]
}
```

### Corps de la requête

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "patch": {
            "type": "object",
            "minProperties": 1,
            "properties": {
              "templateId": {
                "type": "string",
                "format": "uuid",
                "nullable": true
              },
              "emailConfig": {
                "type": "string",
                "maxLength": 200,
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "expectedRevision",
          "idempotencyKey",
          "patch"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Aperçu ou observation/acquittement de réglage limité aux champs autorisés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/NotificationSettingsChangeResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID, type de notification, requête/corps ou valeurs d’exemple invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

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

#### HTTP 404

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

#### HTTP 409

```json
{
  "description": "Modèle/réglages enregistrés invalides, expéditeur indisponible, SYSTEM_TEMPLATE_FIXED, NOTIFICATION_SETTINGS_NOT_INITIALISED, NOTIFICATION_REVISION_CHANGED ou IDEMPOTENCY_CONFLICT. Aucun réglage non pris en charge n’est modifié.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "NOTIFICATION_TEMPLATE_UNAVAILABLE. Ne pas déduire l’échec d’une écriture de réglage incertaine.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /notification-templates/settings/FORM_SUBMITTED/{id}

Consulter les réglages de modèle et d’expéditeur FORM_SUBMITTED

`get_form_submitted_notification_settings`

Le droit explicite notification_settings:read et messages:read pour la référence d’expéditeur sont requis. Les rappels exigent aussi transactional_reminders:read ; les formulaires exigent forms:read ET email_templates:read. Les types d’organisation BIRTHDAY et HAZKARA utilisent id=organisation et un modèle système natif fixe : templateMutable=false ; choisir un modèle d’organisation n’est pas pris en charge. FORM_SUBMITTED et FORM_ACCEPTED utilisent l’UUID d’un formulaire existant. Leur templateId facultatif désigne un email d’organisation SUPPLÉMENTAIRE envoyé à côté de la confirmation système fixe, jamais un remplacement ; templateMode=SYSTEM_PLUS_ORGANISATION l’indique. templateId=null signifie absence d’email d’organisation supplémentaire, pas absence de notification système. emailConfig sélectionne le réglage natif d’expéditeur de ces notifications ; null conserve le repli natif à l’exécution et ne prouve pas un expéditeur particulier ni une configuration SMTP valide. Toutes les références formulaire/modèle/expéditeur sont réadmises indépendamment dans l’organisation ; les clés limitées à des collectes sont refusées. Aucun secret, hôte/utilisateur/mot de passe SMTP, réponse prestataire ni donnée contact n’est retourné. settingsInitialised=false signifie absence du document natif reminderEmailSenders : la lecture rapporte le repli en mémoire sans l’initialiser ; une modification exige l’initialisation dans l’application propriétaire faute de propriétaire natif unique d’upsert/CAS disponible ici. La couverture reste partielle : remerciements de collecte, échecs d’abonnement et autres familles ne sont pas exposés par cette tranche. Lire les réglages n’envoie aucun message, n’initialise aucun état persistant et n’appelle aucun prestataire.

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Réponses

#### HTTP 200

```json
{
  "description": "Aperçu ou observation/acquittement de réglage limité aux champs autorisés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/NotificationSettingsResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID, type de notification, requête/corps ou valeurs d’exemple invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

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

#### HTTP 404

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

#### HTTP 409

```json
{
  "description": "Modèle/réglages enregistrés invalides, expéditeur indisponible, SYSTEM_TEMPLATE_FIXED, NOTIFICATION_SETTINGS_NOT_INITIALISED, NOTIFICATION_REVISION_CHANGED ou IDEMPOTENCY_CONFLICT. Aucun réglage non pris en charge n’est modifié.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "NOTIFICATION_TEMPLATE_UNAVAILABLE. Ne pas déduire l’échec d’une écriture de réglage incertaine.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## PATCH /notification-templates/settings/FORM_SUBMITTED/{id}

Modifier les réglages de modèle ou d’expéditeur FORM_SUBMITTED

`update_form_submitted_notification_settings`

Le droit explicite notification_settings:read et messages:read pour la référence d’expéditeur sont requis. Les rappels exigent aussi transactional_reminders:read ; les formulaires exigent forms:read ET email_templates:read. Les types d’organisation BIRTHDAY et HAZKARA utilisent id=organisation et un modèle système natif fixe : templateMutable=false ; choisir un modèle d’organisation n’est pas pris en charge. FORM_SUBMITTED et FORM_ACCEPTED utilisent l’UUID d’un formulaire existant. Leur templateId facultatif désigne un email d’organisation SUPPLÉMENTAIRE envoyé à côté de la confirmation système fixe, jamais un remplacement ; templateMode=SYSTEM_PLUS_ORGANISATION l’indique. templateId=null signifie absence d’email d’organisation supplémentaire, pas absence de notification système. emailConfig sélectionne le réglage natif d’expéditeur de ces notifications ; null conserve le repli natif à l’exécution et ne prouve pas un expéditeur particulier ni une configuration SMTP valide. Toutes les références formulaire/modèle/expéditeur sont réadmises indépendamment dans l’organisation ; les clés limitées à des collectes sont refusées. Aucun secret, hôte/utilisateur/mot de passe SMTP, réponse prestataire ni donnée contact n’est retourné. settingsInitialised=false signifie absence du document natif reminderEmailSenders : la lecture rapporte le repli en mémoire sans l’initialiser ; une modification exige l’initialisation dans l’application propriétaire faute de propriétaire natif unique d’upsert/CAS disponible ici. La couverture reste partielle : remerciements de collecte, échecs d’abonnement et autres familles ne sont pas exposés par cette tranche. Lire les réglages n’envoie aucun message, n’initialise aucun état persistant et n’appelle aucun prestataire. Une écriture exige aussi notification_settings:write et le droit d’écriture du domaine cible (forms:write pour les formulaires, transactional_reminders:write pour les rappels), ainsi que tous les droits de lecture indiqués. Lire d’abord la cible, puis transmettre son expectedRevision opaque et un UUID idempotencyKey avec uniquement les champs de patch demandés. templateId est accepté uniquement pour les formulaires ; null retire l’email d’organisation supplémentaire, tandis que la notification système reste fixe. emailConfig est un identifiant de configuration Email admis ou null. L’adaptateur modifie uniquement les champs natifs du formulaire ou du document reminderEmailSenders existant avec comparaison avant écriture ; il n’envoie rien, ne modifie aucune audience, n’édite pas le contenu du modèle, ne crée pas de configuration absente et ne réécrit aucun champ sans rapport. Une commande durable liée au principal et à l’organisation précède la mutation. Une clé/charge identique relit sans mutation ; une charge différente entre en conflit. SUCCEEDED acquitte le réglage ; REFUSED enregistre une course perdue de comparaison ; UNCERTAIN couvre une écriture interrompue/incertaine et n’autorise jamais de réessai automatique avec une nouvelle clé. journalRecorded=false signifie que l’acquittement durable final du journal est indisponible : la commande renvoie UNCERTAIN et ne permet jamais de rejeu automatique. Relire la cible et conserver l’incertitude ; ni une modification de réglage ni un choix de modèle ne prouve qu’une notification future sera envoyée ou livrée.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "notification_settings:write",
  "additional": [
    "notification_settings:read",
    "messages:read",
    "forms:read",
    "email_templates:read",
    "forms:write"
  ]
}
```

### 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": {
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "patch": {
            "type": "object",
            "minProperties": 1,
            "properties": {
              "templateId": {
                "type": "string",
                "format": "uuid",
                "nullable": true
              },
              "emailConfig": {
                "type": "string",
                "maxLength": 200,
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "expectedRevision",
          "idempotencyKey",
          "patch"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Aperçu ou observation/acquittement de réglage limité aux champs autorisés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/NotificationSettingsChangeResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID, type de notification, requête/corps ou valeurs d’exemple invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

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

#### HTTP 404

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

#### HTTP 409

```json
{
  "description": "Modèle/réglages enregistrés invalides, expéditeur indisponible, SYSTEM_TEMPLATE_FIXED, NOTIFICATION_SETTINGS_NOT_INITIALISED, NOTIFICATION_REVISION_CHANGED ou IDEMPOTENCY_CONFLICT. Aucun réglage non pris en charge n’est modifié.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "NOTIFICATION_TEMPLATE_UNAVAILABLE. Ne pas déduire l’échec d’une écriture de réglage incertaine.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## GET /notification-templates/settings/FORM_ACCEPTED/{id}

Consulter les réglages de modèle et d’expéditeur FORM_ACCEPTED

`get_form_accepted_notification_settings`

Le droit explicite notification_settings:read et messages:read pour la référence d’expéditeur sont requis. Les rappels exigent aussi transactional_reminders:read ; les formulaires exigent forms:read ET email_templates:read. Les types d’organisation BIRTHDAY et HAZKARA utilisent id=organisation et un modèle système natif fixe : templateMutable=false ; choisir un modèle d’organisation n’est pas pris en charge. FORM_SUBMITTED et FORM_ACCEPTED utilisent l’UUID d’un formulaire existant. Leur templateId facultatif désigne un email d’organisation SUPPLÉMENTAIRE envoyé à côté de la confirmation système fixe, jamais un remplacement ; templateMode=SYSTEM_PLUS_ORGANISATION l’indique. templateId=null signifie absence d’email d’organisation supplémentaire, pas absence de notification système. emailConfig sélectionne le réglage natif d’expéditeur de ces notifications ; null conserve le repli natif à l’exécution et ne prouve pas un expéditeur particulier ni une configuration SMTP valide. Toutes les références formulaire/modèle/expéditeur sont réadmises indépendamment dans l’organisation ; les clés limitées à des collectes sont refusées. Aucun secret, hôte/utilisateur/mot de passe SMTP, réponse prestataire ni donnée contact n’est retourné. settingsInitialised=false signifie absence du document natif reminderEmailSenders : la lecture rapporte le repli en mémoire sans l’initialiser ; une modification exige l’initialisation dans l’application propriétaire faute de propriétaire natif unique d’upsert/CAS disponible ici. La couverture reste partielle : remerciements de collecte, échecs d’abonnement et autres familles ne sont pas exposés par cette tranche. Lire les réglages n’envoie aucun message, n’initialise aucun état persistant et n’appelle aucun prestataire.

### Authentification

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

### Permissions requises

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

### Paramètres

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

### Réponses

#### HTTP 200

```json
{
  "description": "Aperçu ou observation/acquittement de réglage limité aux champs autorisés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/NotificationSettingsResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID, type de notification, requête/corps ou valeurs d’exemple invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

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

#### HTTP 404

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

#### HTTP 409

```json
{
  "description": "Modèle/réglages enregistrés invalides, expéditeur indisponible, SYSTEM_TEMPLATE_FIXED, NOTIFICATION_SETTINGS_NOT_INITIALISED, NOTIFICATION_REVISION_CHANGED ou IDEMPOTENCY_CONFLICT. Aucun réglage non pris en charge n’est modifié.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "NOTIFICATION_TEMPLATE_UNAVAILABLE. Ne pas déduire l’échec d’une écriture de réglage incertaine.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## PATCH /notification-templates/settings/FORM_ACCEPTED/{id}

Modifier les réglages de modèle ou d’expéditeur FORM_ACCEPTED

`update_form_accepted_notification_settings`

Le droit explicite notification_settings:read et messages:read pour la référence d’expéditeur sont requis. Les rappels exigent aussi transactional_reminders:read ; les formulaires exigent forms:read ET email_templates:read. Les types d’organisation BIRTHDAY et HAZKARA utilisent id=organisation et un modèle système natif fixe : templateMutable=false ; choisir un modèle d’organisation n’est pas pris en charge. FORM_SUBMITTED et FORM_ACCEPTED utilisent l’UUID d’un formulaire existant. Leur templateId facultatif désigne un email d’organisation SUPPLÉMENTAIRE envoyé à côté de la confirmation système fixe, jamais un remplacement ; templateMode=SYSTEM_PLUS_ORGANISATION l’indique. templateId=null signifie absence d’email d’organisation supplémentaire, pas absence de notification système. emailConfig sélectionne le réglage natif d’expéditeur de ces notifications ; null conserve le repli natif à l’exécution et ne prouve pas un expéditeur particulier ni une configuration SMTP valide. Toutes les références formulaire/modèle/expéditeur sont réadmises indépendamment dans l’organisation ; les clés limitées à des collectes sont refusées. Aucun secret, hôte/utilisateur/mot de passe SMTP, réponse prestataire ni donnée contact n’est retourné. settingsInitialised=false signifie absence du document natif reminderEmailSenders : la lecture rapporte le repli en mémoire sans l’initialiser ; une modification exige l’initialisation dans l’application propriétaire faute de propriétaire natif unique d’upsert/CAS disponible ici. La couverture reste partielle : remerciements de collecte, échecs d’abonnement et autres familles ne sont pas exposés par cette tranche. Lire les réglages n’envoie aucun message, n’initialise aucun état persistant et n’appelle aucun prestataire. Une écriture exige aussi notification_settings:write et le droit d’écriture du domaine cible (forms:write pour les formulaires, transactional_reminders:write pour les rappels), ainsi que tous les droits de lecture indiqués. Lire d’abord la cible, puis transmettre son expectedRevision opaque et un UUID idempotencyKey avec uniquement les champs de patch demandés. templateId est accepté uniquement pour les formulaires ; null retire l’email d’organisation supplémentaire, tandis que la notification système reste fixe. emailConfig est un identifiant de configuration Email admis ou null. L’adaptateur modifie uniquement les champs natifs du formulaire ou du document reminderEmailSenders existant avec comparaison avant écriture ; il n’envoie rien, ne modifie aucune audience, n’édite pas le contenu du modèle, ne crée pas de configuration absente et ne réécrit aucun champ sans rapport. Une commande durable liée au principal et à l’organisation précède la mutation. Une clé/charge identique relit sans mutation ; une charge différente entre en conflit. SUCCEEDED acquitte le réglage ; REFUSED enregistre une course perdue de comparaison ; UNCERTAIN couvre une écriture interrompue/incertaine et n’autorise jamais de réessai automatique avec une nouvelle clé. journalRecorded=false signifie que l’acquittement durable final du journal est indisponible : la commande renvoie UNCERTAIN et ne permet jamais de rejeu automatique. Relire la cible et conserver l’incertitude ; ni une modification de réglage ni un choix de modèle ne prouve qu’une notification future sera envoyée ou livrée.

### Authentification

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

### Permissions requises

```json
{
  "accepted": "notification_settings:write",
  "additional": [
    "notification_settings:read",
    "messages:read",
    "forms:read",
    "email_templates:read",
    "forms:write"
  ]
}
```

### 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": {
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "patch": {
            "type": "object",
            "minProperties": 1,
            "properties": {
              "templateId": {
                "type": "string",
                "format": "uuid",
                "nullable": true
              },
              "emailConfig": {
                "type": "string",
                "maxLength": 200,
                "nullable": true
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "expectedRevision",
          "idempotencyKey",
          "patch"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Réponses

#### HTTP 200

```json
{
  "description": "Aperçu ou observation/acquittement de réglage limité aux champs autorisés.",
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/NotificationSettingsChangeResponse"
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "UUID, type de notification, requête/corps ou valeurs d’exemple invalide.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

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

#### HTTP 403

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

#### HTTP 404

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

#### HTTP 409

```json
{
  "description": "Modèle/réglages enregistrés invalides, expéditeur indisponible, SYSTEM_TEMPLATE_FIXED, NOTIFICATION_SETTINGS_NOT_INITIALISED, NOTIFICATION_REVISION_CHANGED ou IDEMPOTENCY_CONFLICT. Aucun réglage non pris en charge n’est modifié.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "NOTIFICATION_TEMPLATE_UNAVAILABLE. Ne pas déduire l’échec d’une écriture de réglage incertaine.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

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

## Schémas

```json
{
  "components": {
    "schemas": {
      "NotificationTemplatePreviewResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "templateId",
              "revision",
              "html",
              "subject",
              "preheader",
              "variablesUsed",
              "missingVariables",
              "unsupportedVariables",
              "complete"
            ],
            "properties": {
              "templateId": {
                "type": "string",
                "format": "uuid"
              },
              "revision": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              },
              "html": {
                "type": "string"
              },
              "subject": {
                "type": "string",
                "nullable": true
              },
              "preheader": {
                "type": "string",
                "nullable": true
              },
              "variablesUsed": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "missingVariables": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "unsupportedVariables": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "complete": {
                "type": "boolean"
              }
            }
          }
        }
      },
      "NotificationSettingsResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "kind",
              "resourceId",
              "templateId",
              "systemTemplateFixed",
              "templateMode",
              "templateMutable",
              "emailConfig",
              "senderSelection",
              "settingsInitialised",
              "revision"
            ],
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "BIRTHDAY",
                  "HAZKARA",
                  "FORM_SUBMITTED",
                  "FORM_ACCEPTED"
                ]
              },
              "resourceId": {
                "type": "string"
              },
              "templateId": {
                "type": "string",
                "nullable": true,
                "format": "uuid"
              },
              "systemTemplateFixed": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "templateMode": {
                "type": "string",
                "enum": [
                  "SYSTEM_ONLY",
                  "SYSTEM_PLUS_ORGANISATION"
                ]
              },
              "templateMutable": {
                "type": "boolean"
              },
              "emailConfig": {
                "type": "string",
                "nullable": true
              },
              "senderSelection": {
                "type": "string",
                "enum": [
                  "EXPLICIT",
                  "NATIVE_FALLBACK"
                ]
              },
              "settingsInitialised": {
                "type": "boolean"
              },
              "revision": {
                "type": "string",
                "pattern": "^[a-f0-9]{64}$"
              }
            }
          }
        }
      },
      "NotificationSettingsChangeResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "requestId",
              "status",
              "replayed",
              "journalRecorded"
            ],
            "properties": {
              "requestId": {
                "type": "string",
                "format": "uuid"
              },
              "status": {
                "type": "string",
                "enum": [
                  "SUCCEEDED",
                  "REFUSED",
                  "UNCERTAIN"
                ]
              },
              "replayed": {
                "type": "boolean"
              },
              "journalRecorded": {
                "type": "boolean"
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format : `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
