Listar los temas

GET /api/v1/topics Todos los temas de la organización. Esta es la llamada que te da el topicId que exigen todas las demás llamadas de temas, y leerla está abierto a todos los roles; actuar sobre un tema, no. La lista es completa: no tiene paginación ni búsqueda.

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.

Ejemplo

bash

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

Respuesta

200 OK: los temas, ordenados por nombre. Una organización sin ninguno responde un array vacío.
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`	array	Los temas
`data[].id`	string	Identificador único: es el `topicId` que se usa en todas partes
`data[].name`	string	Nombre del tema, único en la organización
`data[].createdAt`	string	Fecha de creación ISO
`data[].updatedAt`	string	Fecha ISO del último cambio

Ejemplo de respuesta

json

{
  "success": true,
  "data": [
    {
      "id": "7c2e4b19",
      "name": "freelancing",
      "createdAt": "2026-03-04T08:11:00.000Z",
      "updatedAt": "2026-08-01T10:42:19.000Z"
    }
  ]
}

Notas

Aquí no hay ?search= ni paginación. La lista entera llega en una sola llamada: fíltrala de tu lado.
Cambiar el nombre de un tema es seguro: las campañas, las secuencias y los rechazos hacen referencia al id, nunca al nombre.