Listar agentes

Devuelve los agentes a los que tu API Key tiene acceso. Una clave con alcance Todos los agentes devuelve todos los agentes de tu empresa; una clave con alcance Agentes específicos devuelve únicamente los agentes vinculados a esa clave.

Endpoint

GET /v1/agents

Parámetros de consulta

Parámetro	Tipo	Por defecto	Descripción
page	integer	1	Número de página a obtener (empezando en 1). Valores menores a 1 se ajustan a 1.
limit	integer	20	Cantidad de agentes por página. Máximo 100.

Ejemplo de solicitud

curl -X GET "https://api.fonema.ai/v1/agents?page=1&limit=20" \
  -H "Authorization: Bearer TU_API_KEY_AQUI"

Respuesta

{
  "offset": 0,
  "total": 42,
  "limit": 20,
  "currentPage": 1,
  "totalPages": 3,
  "agents": [
    { "name": "Agente de Ventas", "slug": "agente-de-ventas-ab12cd34" },
    { "name": "Agente de Soporte", "slug": "agente-de-soporte-ef56gh78" }
  ]
}

Campos de la respuesta

Campo	Tipo	Descripción
total	integer	Número total de agentes accesibles por esta clave.
limit	integer	Tamaño de página usado en esta respuesta.
offset	integer	Cantidad de agentes omitidos antes de esta página.
currentPage	integer	Página devuelta.
totalPages	integer	Número total de páginas disponibles.
agents	array	Lista de agentes. Cada elemento contiene el name y el slug del agente.

tip

Usa el slug que se devuelve aquí como identificador en las solicitudes de Consultar agente y Editar agente.