---
title: "Run Pipeline"
method: POST
path: "/api/v1/pipelines/{pipeline_id}/run"
tags: ["pipelines"]
---

# Run Pipeline

`POST /api/v1/pipelines/{pipeline_id}/run`

Execute a pipeline on a file, creating an execution DAG with per-step tracking and billing.

## Path parameters

- `pipeline_id` string, required

## Cookies

- `wos-session` string
- `datalab_active_team` string

## Response `200`

Successful Response

- PipelineExecutionResponse
  - `execution_id` string, required
  - `pipeline_id` string, required
  - `pipeline_version` integer, required
  - `status` string, required
  - `steps` PipelineExecutionStepResponse[], required
    - `step_index` integer, required
    - `step_type` string, required
    - `status` string, required
    - `lookup_key` string, nullable
    - `result_url` string, nullable
    - `started_at` string, date-time, nullable
    - `finished_at` string, date-time, nullable
    - `error_message` string, nullable
    - `source_step_type` string, nullable
    - `checkpoint_id` string, nullable
  - `started_at` string, date-time, nullable
  - `completed_at` string, date-time, nullable
  - `created` string, date-time, nullable
  - `config_snapshot` object, nullable
  - `input_config` object, nullable
  - `rate_breakdown` object, nullable

## Other responses

- `422` — Validation Error

---

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