PATCH /api/v1/templates/{templateId}
Modifie un modèle. Seuls les champs que vous envoyez sont touchés ; les autres restent tels quels.
Un content que vous envoyez passe par la même conversion des balises de fusion, et la réponse porte à nouveau unsupportedTags — vide si vous n'avez pas touché au contenu.
Autorisation
| Rôle dans l'organisation | Cet endpoint |
|---|---|
OWNER | Autorisé |
ADMIN | Autorisé |
MEMBER | Refusé — 403 |
Paramètres de chemin
| Paramètre | Type | Description |
|---|---|---|
templateId | string | Obligatoire. Le modèle à modifier |
Corps de la requête
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
name | string | non | Nouveau nom |
defaultSubject | string | non | Nouvel objet par défaut |
content | string | non | Nouveau HTML — les balises Mailchimp sont converties à l'enregistrement |
Corps de la requête
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
name | string | non | De 1 à 100 caractères |
defaultSubject | string | non | De 1 à 200 caractères |
content | string | non | Le HTML de l'e-mail |
Exemple
bash
curl -X PATCH -H "x-api-key: $AGENTMAIL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"defaultSubject": "August news"}' \
"https://www.agentsmail.io/api/v1/templates/$TEMPLATE_ID"Réponse
200 OK— l'appel a réussi.400 Bad Request— la validation a échoué ;detailsporte les erreurs champ par champ.401 Unauthorized— clé absente ou invalide, ou son propriétaire a quitté l'organisation.403 Forbidden— le propriétaire de la clé estmemberde l'organisation, pasadmin.404 Not Found— ressource inexistante, ou elle appartient à une autre organisation. L'API ne confirme jamais qu'un identifiant existe à un appelant qui n'y a pas droit.429 Too Many Requests— plus de 120 requêtes en une minute pour cette clé.
Champs de la réponse
| Champ | Type | Description |
|---|---|---|
success | boolean | Indique si l'opération a réussi |
data.id | string | Identifiant du modèle |
data.name | string | Son nom |
data.defaultSubject | string | Objet dont hérite une campagne — et qu'elle peut remplacer |
data.content | string | Le document HTML complet |
data.createdAt / updatedAt | string | Dates ISO |
data.unsupportedTags | array | Balises Mailchimp laissées telles quelles dans votre HTML — lisez-le |
Exemple de réponse
json
{
"success": true,
"data": {
"id": "4d19c0a2",
"name": "Newsletter",
"defaultSubject": "August news",
"content": "<html>…</html>",
"createdAt` / `updatedAt": "value",
"unsupportedTags": []
}
}