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

# Activar automatización

> Activa una automatización programada para que se ejecute de inmediato, en lugar de esperar a su próxima hora programada. Útil para ejecutar automatizaciones desde pipelines CI/CD, como una GitHub Action que se ejecuta en cada fusión a tu rama predeterminada. Solo se pueden activar automatizaciones programadas (con programación personalizada). La ejecución recoge los cambios desde la última ejecución completada, de forma idéntica a una ejecución programada normal.

Usa este endpoint para activar bajo demanda una automatización programada, en lugar de esperar a su próxima ejecución programada. La automatización se comporta de forma idéntica a una ejecución programada normal: recoge todo lo que ha cambiado desde la última ejecución completada.

Este endpoint solo admite automatizaciones configuradas con un activador de **Programación personalizada**. Las solicitudes para automatizaciones con otros activadores, como **Cambio de código** o **Actualización de contenido**, devuelven un error `400`.

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

* **Pipelines CI/CD**: Ejecuta la automatización **Update from code changes** en cada fusión a `main`, para que la documentación se actualice según tu cadencia de versiones en lugar de hacerlo según una programación fija.
* **Eventos de versión**: Ejecuta la automatización **Draft changelog** cuando creas una etiqueta de versión, para que el changelog se redacte al mismo tiempo que se publica la versión.
* **Herramientas personalizadas**: Activa automatizaciones desde herramientas internas, comandos de Slack o tareas programadas que ya ejecutas.

<div id="find-the-automation-id">
  ## Encuentra el ID de la automatización
</div>

Copia el ID de la automatización desde el panel de configuración de la automatización en la página [Automatizaciones](https://app.mintlify.com/products/automations) de tu dashboard.

<div id="example">
  ## Ejemplo
</div>

Activa una automatización desde una GitHub Action cada vez que se fusiona código a `main`:

```yaml .github/workflows/trigger-docs.yml theme={null}
on:
  push:
    branches: [main]

jobs:
  trigger:
    runs-on: ubuntu-latest
    steps:
      - run: |
          curl -fsS -X POST \
            "https://api.mintlify.com/v1/workflow/$PROJECT_ID/$WORKFLOW_ID/trigger" \
            -H "Authorization: Bearer ${{ secrets.MINTLIFY_API_KEY }}"
        env:
          PROJECT_ID: ${{ vars.MINTLIFY_PROJECT_ID }}
          WORKFLOW_ID: ${{ vars.MINTLIFY_WORKFLOW_ID }}
```

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

Este endpoint comparte un límite de tasa con [Trigger update](/es/api/update/trigger): hasta 5 solicitudes por minuto por organización. Las ejecuciones activadas consumen créditos al mismo ritmo que las ejecuciones programadas.


## OpenAPI

````yaml es/openapi.json POST /workflow/{projectId}/{workflowSchemaId}/trigger
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:
  /workflow/{projectId}/{workflowSchemaId}/trigger:
    post:
      summary: Activar automatización
      description: >-
        Activa una automatización programada para que se ejecute de inmediato,
        en lugar de esperar a su próxima hora programada. Útil para ejecutar
        automatizaciones desde pipelines CI/CD, como una GitHub Action que se
        ejecuta en cada fusión a tu rama predeterminada. Solo se pueden activar
        automatizaciones programadas (con programación personalizada). La
        ejecución recoge los cambios desde la última ejecución completada, de
        forma idéntica a una ejecución programada normal.
      parameters:
        - name: projectId
          in: path
          description: >-
            El ID de tu proyecto. Puedes copiarlo de la página de [API
            keys](https://app.mintlify.com/settings/organization/api-keys) de tu
            dashboard.
          required: true
          schema:
            type: string
        - name: workflowSchemaId
          in: path
          description: >-
            El ID de la automatización que se va a activar. Puedes copiarlo del
            panel de configuración de la automatización en la página
            [Automatizaciones](https://app.mintlify.com/products/automations) de
            tu dashboard.
          required: true
          schema:
            type: string
      responses:
        '202':
          description: Ejecución de la automatización puesta en cola correctamente.
          content:
            application/json:
              schema:
                type: object
                properties:
                  schemaId:
                    type: string
                    description: El ID de la automatización activada.
                  instanceId:
                    type: string
                    description: >-
                      El ID de la ejecución de la automatización puesta en cola.
                      Aparece en el historial de ejecuciones en la página
                      [Ejecuciones de
                      automatizaciones](https://app.mintlify.com/products/automations).
                  jobId:
                    type: string
                    description: >-
                      El ID del trabajo en segundo plano que procesa la
                      ejecución.
        '400':
          description: >-
            Solicitud no válida. El ID de la automatización tiene un formato
            incorrecto, la automatización no está activa o no está configurada
            con una programación personalizada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
        '404':
          description: No se encontró la automatización o no pertenece a este proyecto.
          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.

````