---
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`

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

---

[API](https://skmtc.net/skyvern-ai/apis/skyvern-api.md) · [All operations](https://skmtc.net/skyvern-ai/apis/skyvern-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skyvern-ai/skyvern-api/revisions/7024de9949d2/schema)