---
title: "Cancel a run by id"
method: POST
path: "/v1/runs/{run_id}/cancel"
tags: ["Runs"]
---

# Cancel a run by id

`POST /v1/runs/{run_id}/cancel`

## Request

- Base URL: `https://api.skyvern.com`
- URL: `https://api.skyvern.com/v1/runs/{run_id}/cancel`
- Auth: none declared

Cancel a run (task or workflow)

## Path parameters

- `run_id` string, required: The id of the task run or the workflow run to cancel.

## Headers

- `x-api-key` string, nullable: Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-06-13** `e7044f43e57e`: 2 info
  - api tag `Runs` added
  - api tag `Agents` removed
- **2026-06-07** `e37d309fc58f`: 3 info
  - api tag `Agents` added
  - api tag `Agent` removed
  - api tag `Workflow Runs` removed

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

---

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