Lister les modèles

GET /api/v1/templates Chaque modèle porte id, name, defaultSubject, content et ses dates createdAt / updatedAt. Rien d'autre.

Autorisation

Rôle dans l'organisation	Cet endpoint
`OWNER`	Autorisé
`ADMIN`	Autorisé
`MEMBER`	Autorisé

Une clé porte le rôle que son créateur détient dans cette organisation — jamais un rôle sur AgentsMail lui-même. Voir Clés d'API.

Paramètres de requête

Paramètre	Type	Description
`search`	string	Cherche dans le nom du modèle, sans tenir compte de la casse
`page`	number	Vaut `1` par défaut
`limit`	number	Vaut `20` par défaut, plafonné à `100`

Exemple

bash

curl -H "x-api-key: $AGENTMAIL_API_KEY" \
  "https://www.agentsmail.io/api/v1/templates?search=newsletter"

Réponse

200 OK — l'appel a réussi.
401 Unauthorized — clé absente ou invalide, ou son propriétaire a quitté l'organisation.
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 unique du modèle
`data[].name`	string	Nom du modèle
`data[].defaultSubject`	string	Objet dont hérite une campagne, et qu'elle peut remplacer
`data[].content`	string	Le document HTML complet
`data[].createdAt`	string	Date de création ISO
`data[].updatedAt`	string	Date ISO de la dernière modification
`pagination`	object	`{total, page, limit, totalPages}`

Exemple de réponse

json

{
  "success": true,
  "data": [
    {
      "id": "4d19c0a2",
      "name": "Newsletter",
      "defaultSubject": "August news",
      "content": "<html>…</html>",
      "createdAt": "2026-08-23T10:22:05.000Z",
      "updatedAt": "2026-08-23T10:22:05.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}