Listar las plantillas

GET /api/v1/templates Cada plantilla lleva id, name, defaultSubject, content y sus fechas createdAt / updatedAt. Nada más.

Autorización

Rol en la organización	Este endpoint
`OWNER`	Permitido
`ADMIN`	Permitido
`MEMBER`	Permitido

Una clave lleva el rol que su creador tiene en esta organización, nunca un rol sobre AgentsMail en sí. Consulta Claves de API.

Parámetros de consulta

Parámetro	Tipo	Descripción
`search`	string	Busca en el nombre de la plantilla, sin distinguir mayúsculas
`page`	number	Por defecto `1`
`limit`	number	Por defecto `20`, con un máximo de `100`

Ejemplo

bash

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

Respuesta

200 OK: la llamada se realizó correctamente.
401 Unauthorized: clave ausente o no válida, o su propietario salió de la organización.
429 Too Many Requests: más de 120 solicitudes en un minuto para esta clave.

Campos de la respuesta

Campo	Tipo	Descripción
`success`	boolean	Indica si la operación se realizó correctamente
`data[].id`	string	Identificador único de la plantilla
`data[].name`	string	Nombre de la plantilla
`data[].defaultSubject`	string	Asunto que hereda una campaña, y que puede sobrescribir
`data[].content`	string	El documento HTML completo
`data[].createdAt`	string	Fecha de creación ISO
`data[].updatedAt`	string	Fecha ISO del último cambio
`pagination`	object	`{total, page, limit, totalPages}`

Ejemplo de respuesta

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
  }
}