mintlify__docs/es/api/introduction.mdx

---
title: "Introducción"
description: "Lanza actualizaciones, integra el assistant, exporta datos de Analytics y más"
keywords: ["REST API", "endpoints", "API keys"]
---

La REST API de Mintlify te permite interactuar de forma programática con tu documentación, lanzar actualizaciones, integrar experiencias de chat impulsadas por IA y exportar datos de Analytics.

<div id="endpoints">
  ## Endpoints
</div>

* [Trigger update](/es/api-reference/update/trigger): Activa una actualización de tu sitio cuando lo desees.
* [Get update status](/es/api-reference/update/status): Obtén el estado de una actualización y otros detalles de tu documentación.
* [Create agent job](/es/api-reference/agent/create-agent-job): Crea un trabajo de agente para editar tu documentación automáticamente.
* [Get agent job](/es/api-reference/agent/get-agent-job): Obtén los detalles y el estado de un trabajo de agente específico.
* [Get all agent jobs](/es/api-reference/agent/get-all-jobs): Obtén todos los trabajos de agente para un domain.
* [Generate assistant message](/es/api-reference/assistant/create-assistant-message): Integra el assistant, entrenado con tu documentación, en cualquier aplicación que elijas.
* [Search documentation](/es/api-reference/assistant/search): Busca en tu documentación.
* [Get user feedback](/es/api-reference/analytics/feedback): Exporta los comentarios de los usuarios de tu documentación.
* [Get assistant conversations](/es/api-reference/analytics/assistant-conversations): Exporta el historial de conversaciones del Asistente de IA.

<div id="common-use-cases">
  ### Casos de uso comunes
</div>

* **Implementaciones automatizadas**: Activa actualizaciones del sitio en intervalos definidos o cuando se produzcan determinados eventos con [Trigger update](/es/api-reference/update/trigger) y [Get update status](/es/api-reference/update/status).
* **Integración CI/CD**: Actualiza la documentación como parte de tu pipeline de implementación cuando cambie el código con [Trigger update](/es/api-reference/update/trigger).
* **Integraciones personalizadas**: Integra el Asistente de IA en tu producto, portal de soporte o herramientas internas con [Generate assistant message](/es/api-reference/assistant/create-assistant-message) y [Search documentation](/es/api-reference/assistant/search).
* **Edición automatizada**: Usa trabajos de agente para actualizar la documentación de forma programática y a escala con [Create agent job](/es/api-reference/agent/create-agent-job), [Get agent job](/es/api-reference/agent/get-agent-job) y [Get all agent jobs](/es/api-reference/agent/get-all-jobs).
* **Exportación de Analytics**: Exporta comentarios de usuarios y conversaciones con el Asistente de IA para análisis externo con [Get user feedback](/es/api-reference/analytics/feedback) y [Get assistant conversations](/es/api-reference/analytics/assistant-conversations).

<div id="authentication">
  ## Autenticación
</div>

Puedes generar API keys en la [página de API keys](https://dashboard.mintlify.com/settings/organization/api-keys) de tu dashboard. Cada API key pertenece a una organización; puedes usar API keys en múltiples implementaciones dentro de la misma organización.

Puedes crear hasta 10 API keys por hora y por organización.

<div id="admin-api-key">
  ### Clave de la API de administrador
</div>

Usa la clave de la API de administrador para autenticar solicitudes a [Activar actualización](/es/api-reference/update/trigger), [Obtener estado de la actualización](/es/api-reference/update/status), [Crear tarea de agente](/es/api-reference/agent/create-agent-job), [Obtener tarea de agente](/es/api-reference/agent/get-agent-job), [Obtener todas las tareas de agente](/es/api-reference/agent/get-all-jobs), [Obtener comentarios de los usuarios](/es/api-reference/analytics/feedback) y [Obtener conversaciones del assistant](/es/api-reference/analytics/assistant-conversations).

Las claves de la API de administrador comienzan con el prefijo `mint_`.

La clave de la API de administrador es un secreto del lado del servidor. No la expongas en código del lado del cliente.

<div id="assistant-api-key">
  ### key del Assistant API
</div>

Usa la key del Assistant API para autenticar solicitudes a los endpoints [Generate assistant message](/es/api-reference/assistant/create-assistant-message) y [Search documentation](/es/api-reference/assistant/search).

Las keys del Assistant API comienzan con el prefijo `mint_dsc_`.

La key del Assistant API es un token público que puede referenciarse en tu código de frontend.

<Note>
  Las llamadas que usan el token del Assistant API pueden generar costos: ya sea usando tus créditos del assistant o incurriendo en excedentes.
</Note>