> ## Documentation Index
> Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> Interactúa con AthenaHQ e intégralo mediante programación

## 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.

> [card] [Crear claves de API](https://app.athenahq.ai/organization?tab=api)
>
> Genera y gestiona claves de API en los ajustes de tu organización

> [!NOTE]
>
> Para conocer los métodos de autenticación y la gestión de claves de API,
> consulta la documentación de [Autenticación](https://docs.athenahq.ai/es/api-reference/authentication.md).

## 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. Utiliza `filters.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`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.