---
title: "Bulk cancel runs"
method: POST
path: "/v1/runs/cancel"
tags: ["Runs"]
---

# Bulk cancel runs

`POST /v1/runs/cancel`

## Request

- Base URL: `https://api.skyvern.com`
- URL: `https://api.skyvern.com/v1/runs/cancel`
- Auth: API key in header `x-api-key`

Cancel multiple runs (tasks or workflows) in a single request

## Request body

- BulkCancelRunsRequest
  - `run_ids` string[], required: List of run IDs to cancel

## Response `200`

Successful Response

- BulkCancelRunsResponse
  - `cancelled` string[], required: Run IDs that were successfully cancelled
  - `failed` string[], required: Run IDs that could not be cancelled

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-20** `539f04093540`: 1 warning, 1 info
  - deleted the `header` request parameter `x-api-key`
  - the endpoint scheme security `ApiKeyAuth` was added to the API
- **2026-06-09** `e5a0a7c3a5c6`: 2 info
  - api tag `Runs` added
  - api tag `Agents` removed
- **2026-06-08** `3a3616091b66`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/changes/v1/runs/cancel/post.md)

---

[API](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2.md) - [All operations](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/revisions/64479cb160ff?raw)