# Activar implementación de vista previa (/es/api/preview/trigger)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 911 · updated: 2026-07-30 -->
Related: [Iniciar implementación](/es/api/update/trigger.md), [Activar automatización](/es/api/automations/trigger.md)

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 [#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 [#límites-de-tasa]
</div>

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

`POST /project/preview/{projectId}`

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.

Autentícate con una clave de API de administrador.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "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"
              }
            }
          }
        }
      }
    }
  }
}
```