---
title: "Start a pipeline run"
method: POST
path: "/pipelines/{pipeline_id_or_alias}/start"
tags: ["Pipelines"]
---

# Start a pipeline run

`POST /pipelines/{pipeline_id_or_alias}/start`

Start a pipeline run. The pipeline can be identified by alias or pipeline ID.

All request body fields are optional. Use `branch` and `commit` for Git-backed pipelines, `versionNumber` for Orchestra-backed published versions, and `runInputs` for values required by pipeline inputs. The response includes a `pipelineRunId` you can use to poll run status.

## Path parameters

- `pipeline_id_or_alias` union, required
  - string, uuid4
  - string

## Request body

- WebhookRequestData — Full webhook request body for triggering a pipeline run.
  - `versionNumber` integer, nullable
  - `branch` string, nullable
  - `commit` string, nullable
  - `taskIds` string[], nullable
  - `continueDownstreamRun` boolean, nullable
  - `runInputs` object, nullable
  - `data` AirflowWebhookRequest[]
    - `integration` 'AIRFLOW', required
    - `dagId` string, required
    - `dagRunId` string, required
  - `ciRunId` string, nullable
  - `environment` string, nullable
  - `environmentOverrides` object, nullable
  - `retryFromFailed` boolean

## Response `200`

Successful response.

- StartPipelineResponse — Response returned when starting a pipeline.
  - `id` string, uuid4, required
  - `pipelineRunId` string, uuid4, required
  - `message` string, nullable

## Other responses

- `401` — The request was not authorized. Check the API key and `Authorization` header.
- `403` — The request was forbidden, or the Metadata API is not enabled for this workspace.
- `404` — The requested resource was not found.
- `422` — Validation failed. Check path parameters, query parameters, and JSON request bodies.
- `429` — Too many requests. Wait before sending more requests.
- `504` — The pipeline start request timed out. Try again.

---

[API](https://skmtc.dev/getorchestra/apis/orchestra-api.md) · [All operations](https://skmtc.dev/getorchestra/apis/orchestra-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getorchestra/orchestra-api/revisions/50f4d2ba114d/schema)