mintlify__docs/es/api/introduction.mdx

---
title: "Introducción"
description: "Usa la API REST de Mintlify para lanzar despliegues, integrar un asistente de IA, exportar datos de Analytics y gestionar la documentación de forma programática."
keywords: ["REST API", "endpoints", "API keys"]
boost: 3
---

La REST (Representational State Transfer) 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/admin/trigger-update): Activa una actualización de tu sitio cuando quieras.
- [Get update status](/es/api/admin/get-update-status): Obtén el estado de una actualización y otros detalles de tu documentación.
- [Trigger preview deployment](/es/api/admin/trigger-preview-deployment): Crea o actualiza una implementación de vista previa para una rama específica.
- [Create agent job](/es/api/agent/create-agent-job): Crea una tarea de agente para editar tu documentación automáticamente.
- [Get agent job](/es/api/agent/get-agent-job): Obtén los detalles y el estado de una tarea de agente específica.
- [Send follow-up message](/es/api/agent/send-follow-up-message): Envía un mensaje de seguimiento a una tarea de agente existente.
- [Create assistant message](/es/api/assistant/create-assistant-message): Integra el assistant, entrenado con tu documentación, en cualquier aplicación que elijas.
- [Search documentation](/es/api/assistant/search-documentation): Busca en tu documentación.
- [Get page content](/es/api/assistant/get-page-content): Recupera el contenido de texto completo de una página de documentación.
- [Get user feedback](/es/api/analytics/get-feedback): Exporta los comentarios de los usuarios de tu documentación.
- [Get assistant conversations](/es/api/analytics/get-assistant-conversations): Exporta el historial de conversaciones del Asistente de IA.
- [Get assistant caller stats](/es/api/analytics/get-assistant-caller-stats): Obtén un desglose de los recuentos de consultas del assistant por tipo de origen.

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

- **Implementaciones automatizadas**: Activa actualizaciones del sitio a intervalos establecidos o cuando se produzcan eventos con [Trigger update](/es/api/admin/trigger-update) y [Get update status](/es/api/admin/get-update-status).
- **Integración CI/CD**: Actualiza la documentación como parte de tu pipeline de implementación cuando el código cambie con [Trigger update](/es/api/admin/trigger-update).
- **Implementaciones de vista previa**: Crea o actualiza implementaciones de vista previa de forma programática en tu pipeline CI/CD con [Trigger preview deployment](/es/api/admin/trigger-preview-deployment).
- **Integraciones personalizadas**: Inserta el Asistente de IA en tu producto, portal de soporte o herramientas internas con [Create assistant message](/es/api/assistant/create-assistant-message), [Search documentation](/es/api/assistant/search-documentation) y [Get page content](/es/api/assistant/get-page-content).
- **Edición automatizada**: Usa trabajos de agente para actualizar la documentación programáticamente y a escala con [Create agent job](/es/api/agent/create-agent-job), [Get agent job](/es/api/agent/get-agent-job) y [Send follow-up message](/es/api/agent/send-follow-up-message).
- **Exportación de Analytics**: Exporta comentarios, conversaciones del assistant y datos de visitantes para análisis externo con [Get user feedback](/es/api/analytics/get-feedback), [Get assistant conversations](/es/api/analytics/get-assistant-conversations) y [Get assistant caller stats](/es/api/analytics/get-assistant-caller-stats).

<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 [Trigger update](/es/api/admin/trigger-update), [Get update status](/es/api/admin/get-update-status), [Trigger preview deployment](/es/api/admin/trigger-preview-deployment), [Create agent job](/es/api/agent/create-agent-job), [Get agent job](/es/api/agent/get-agent-job), [Send follow-up message](/es/api/agent/send-follow-up-message), [Get user feedback](/es/api/analytics/get-feedback), [Get assistant conversations](/es/api/analytics/get-assistant-conversations) y [Get assistant caller stats](/es/api/analytics/get-assistant-caller-stats).

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 [Create assistant message](/es/api/assistant/create-assistant-message), [Search documentation](/es/api/assistant/search-documentation) y [Get page content](/es/api/assistant/get-page-content).

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>