Listar agentes

Obtén todos los agentes del negocio asociado a tu API key.

GET/api/external/v2/agents

Autenticación

Este endpoint se autentica con una API key mediante la cabecera X-API-Key (formato ek_live_...), en lugar del token bearer del resto de la referencia.

Autenticación

ParámetroTipoObligatorioDescripción
X-API-KeyStringObligatorioAPI key del negocio enviada en la cabecera X-API-Key.

Ejemplo de solicitud

bash
curl -X GET "https://eclectic-api-537143970188.us-central1.run.app/api/external/v2/agents" \
  -H "X-API-Key: ek_live_your_api_key_here"

Ejemplo de respuesta

json
{
  "agents": [
    {
      "id": "4b2f7a1e-0e88-4aa7-bf67-7d0a3e0f5b91",
      "name": "Support Agent",
      "type": "BASIC",
      "system_prompt": "Help customers with clear and concise answers.",
      "tools": {
        "handoff_to_human_control": {
          "enabled": true,
          "instructions": "..."
        }
      }
    }
  ],
  "business_id": "2a4b8d4b-23fa-420a-94c2-cb9a4d2c7fb8"
}

Notas

  • La respuesta solo incluye agentes del negocio autenticado por la API key.
  • Cada agente usa el mismo formato completo que devuelven los endpoints de detalle y actualización.