---
title: "Cancel a pipeline run"
method: POST
path: "/pipeline_runs/{pipeline_run_id}/cancel"
tags: ["Pipeline Runs"]
---

# Cancel a pipeline run

`POST /pipeline_runs/{pipeline_run_id}/cancel`

Cancel a pipeline run. Pass `force: true` in the optional body to force cancellation.

## Path parameters

- `pipeline_run_id` string, uuid4, required

## Request body

- CancelPipelineRunRequestBody — Optional payload for cancelling a pipeline run.
  - `force` boolean

## Response `204`

Operation completed successfully. Empty response body.

## 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.
- `422` — Validation failed. Check path parameters, query parameters, and JSON request bodies.

---

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