# Activar automatización (/es/api/automations/trigger)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1369 · updated: 2026-07-30 -->
Related: [Activar implementación de vista previa](/es/api/preview/trigger.md), [Detectar prosa que suena a IA](/es/api/admin/deslop.md)

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 [#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 [#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 [#ejemplo]
</div>

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

```yaml title=".github/workflows/trigger-docs.yml"
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 [#límites-de-tasa]
</div>

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

`POST /workflow/{projectId}/{workflowSchemaId}/trigger`

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.

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://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"
              }
            }
          }
        }
      }
    }
  }
}
```