API de AthenaHQ
La API de AthenaHQ permite interactuar con la plataforma mediante programación y a gran escala. Crea integraciones personalizadas, automatiza flujos de trabajo y amplía las funciones de AthenaHQ para adaptarlas a las necesidades de tu organización.Autenticación
Todas las solicitudes a la API requieren autenticación mediante una clave de API. Puedes gestionar las claves desde el panel de tu organización y restringirlas a sitios web concretos para controlar el acceso con mayor precisión.Crear claves de API
Genera y gestiona claves de API en los ajustes de tu organización
Para conocer los métodos de autenticación y la gestión de claves de API,
consulta la documentación de Autenticación.
Fechas y zonas horarias
Todas las marcas de tiempo que se envían a la API y las que esta devuelve están en UTC, salvo que se indique lo contrario.Ejecuciones programadas
Los análisis de respuestas seleccionan una sola programación cada vez. Utilizafilters.schedule_id en las solicitudes JSON: default (también se aplica si lo omites), manual o el UUID de una programación personalizada. La programación predeterminada incluye todo el historial anterior a la transición. Las programaciones archivadas conservan sus resultados. filters.schedule_id admite exactamente una programación; si envías una lista, devuelve 400.
Hay otras dos vías para combinar varias programaciones, incluidas las archivadas. Las herramientas MCP query_metrics y query_rows aceptan un array en schedule, como ["default", "<schedule UUID>"]. Además, los endpoints de métricas aplican las programaciones de una vista guardada cuando envías esa vista como filters.saved_view_id. Si incluyes filters.schedule_id junto a la vista, esa única programación sustituye las programaciones de la vista. Como cada programación puede tener una frecuencia distinta, los recuentos y las tendencias combinados mezclan esas frecuencias.
Consulta las programaciones disponibles con GET /api/v1/prompt-schedules?website_id=... y utiliza el valor selection de cada fila. En GET /api/v1/date-range, pasa ese valor como parámetro de consulta schedule_id. El equivalente en MCP es get_prompt_schedules.