Parcourir le catalogue de thèmes

GET /api/v1/signup-page-templates Les thèmes de pages d'inscription que nous maintenons, dans l'ordre du catalogue. Prenez le content de l'un d'eux, envoyez-le comme content de votre page, et vous avez une page fonctionnelle sans écrire une ligne de HTML. Lecture seule. Il n'existe aucun endpoint pour ajouter, modifier ou retirer un thème : le catalogue appartient au produit, pas à une organisation, et il est le même pour toutes les clés.

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.

Exemple

bash

curl -H "x-api-key: $AGENTMAIL_API_KEY" \
  "https://www.agentsmail.io/api/v1/signup-page-templates"

Réponse

200 OK — les thèmes publiés, dans l'ordre du catalogue.
401 Unauthorized — clé absente ou invalide, ou son propriétaire a quitté l'organisation.
429 Too Many Requests — la clé a dépassé sa limite de débit.

Champs de la réponse

Champ	Type	Description
`success`	boolean	Indique si l'opération a réussi
`data`	array	Les thèmes
`data[].id`	string	Identifiant unique du thème
`data[].name`	string	Son nom — mettez-le dans `sourceTemplateName` quand vous le copiez
`data[].description`	string \| null	Une ligne sur son apparence
`data[].content`	string	Le HTML à copier dans votre page
`data[].previewImageUrl`	string \| null	Une vignette du thème, quand il en a une
`data[].position`	number	Ordre dans le catalogue, du plus petit au plus grand
`data[].createdAt`	string	Date de création ISO
`data[].updatedAt`	string	Date ISO de la dernière modification

Exemple de réponse

json

{
  "success": true,
  "data": [
    {
      "id": "2f2f2f2f-5555-4aaa-8bbb-999900001111",
      "name": "Minimal",
      "description": "One column, one form, nothing else",
      "content": "<html><body><h1>{{heroTitle}}</h1>{{form}}{{poweredBy}}</body></html>",
      "previewImageUrl": "https://www.agentsmail.io/thumbnails/minimal.png",
      "position": 1,
      "createdAt": "2026-07-01T09:00:00.000Z",
      "updatedAt": "2026-08-02T10:00:00.000Z"
    }
  ]
}

Remarques

Ni pagination ni recherche ici. Tout le catalogue revient en un seul appel — filtrez-le de votre côté.
Ce qui revient est toujours publié. Un thème encore en préparation ne figure pas dans cette liste, et rien dans la réponse n'indique qu'un thème pourrait être autre chose.
Chaque thème contient {{form}} : une copie est donc acceptée telle quelle. Modifiez-la et le résultat vous appartient : la balise {{form}} doit survivre à vos modifications.