GET /api/v1/templates/{templateId}
Un modèle, avec son HTML complet dans content.
bash
curl -H "x-api-key: $AGENTMAIL_API_KEY" \
"https://www.agentsmail.io/api/v1/templates/$TEMPLATE_ID"404, comme un identifiant qui n'existe pas.
Autorisation
| Rôle dans l'organisation | Cet endpoint |
|---|---|
OWNER | Autorisé |
ADMIN | Autorisé |
MEMBER | Autorisé |
Paramètres de chemin
| Paramètre | Type | Description |
|---|---|---|
templateId | string | Obligatoire. Le modèle à lire |
Exemple
bash
curl -H "x-api-key: $AGENTMAIL_API_KEY" \
"https://www.agentsmail.io/api/v1/templates/$TEMPLATE_ID"Réponse
200 OK— l'appel a réussi.401 Unauthorized— clé absente ou invalide, ou son propriétaire a quitté l'organisation.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 |
Exemple de réponse
json
{
"success": true,
"data": {
"id": "4d19c0a2",
"name": "Newsletter",
"defaultSubject": "August news",
"content": "<html>…</html>",
"createdAt` / `updatedAt": "value"
}
}