> ## Documentation Index
> Fetch the complete documentation index at: https://smartac-justin-client-exports.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Activar implementación de vista previa

> Crea o actualiza una implementación de vista previa para una rama específica. Si ya existe una vista previa para la rama, se activa una reimplementación. Devuelve un ID de estado para hacer seguimiento del progreso y la URL de la vista previa.

Usa este endpoint para crear o actualizar de forma programática una implementación de vista previa para una rama de Git. Si ya existe una vista previa para la rama especificada, el endpoint activa una reimplementación en lugar de crear un duplicado.

La respuesta incluye un `statusId` que puedes pasar a [Get deployment status](/es/api/update/status) para rastrear el progreso de la implementación.

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

* **Pipelines CI/CD**: Crea automáticamente implementaciones de vista previa cuando se abren o actualizan solicitudes de extracción.
* **Vistas previas programadas**: Genera vistas previas de ramas de funcionalidades de larga duración de forma programada.
* **Herramientas personalizadas**: Integra la creación de vistas previas en flujos de trabajo internos o bots de Slack.

<div id="rate-limits">
  ## Límites de tasa
</div>

Este endpoint permite hasta 5 solicitudes por minuto por organización.


## OpenAPI

````yaml es/openapi.json POST /project/preview/{projectId}
openapi: 3.0.1
info:
  title: Mintlify External API
  description: Una API para gestionar la documentación de Mintlify y acceder a recursos.
  version: 1.0.0
servers:
  - url: https://api.mintlify.com/v1
security:
  - bearerAuth: []
paths:
  /project/preview/{projectId}:
    post:
      summary: Activar implementación de vista previa
      description: >-
        Crea o actualiza una implementación de vista previa para una rama
        específica. Si ya existe una vista previa para la rama, se activa una
        reimplementación. Devuelve un ID de estado para hacer seguimiento del
        progreso y la URL de la vista previa.
      parameters:
        - name: projectId
          in: path
          description: >-
            El ID de tu proyecto. Puedes copiarlo de la página de [API
            keys](https://dashboard.mintlify.com/settings/organization/api-keys)
            de tu dashboard.
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - branch
              properties:
                branch:
                  type: string
                  description: >-
                    El nombre de la rama de Git para la cual crear una
                    implementación de vista previa.
                  minLength: 1
      responses:
        '202':
          description: Implementación de vista previa puesta en cola correctamente.
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusId:
                    type: string
                    description: >-
                      El ID de estado para hacer seguimiento de la
                      implementación de vista previa. Úsalo con el endpoint [Get
                      deployment status](/es/api/update/status).
                  previewUrl:
                    type: string
                    description: La URL donde se aloja la implementación de vista previa.
        '400':
          description: Solicitud no válida. El campo `branch` es obligatorio.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '403':
          description: >-
            Las implementaciones de vista previa no están disponibles en tu plan
            actual.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        El encabezado Authorization espera un token de tipo Bearer. Usa una
        clave de API de administrador (con el prefijo `mint_`). Esta es una
        clave secreta del lado del servidor. Genera una en la [página de claves
        de API](https://dashboard.mintlify.com/settings/organization/api-keys)
        de tu dashboard.

````