---
title: "Cancel a workflow run"
method: POST
path: "/repos/{owner}/{repo}/actions/runs/{run_id}/cancel"
tags: ["actions"]
---

# Cancel a workflow run

`POST /repos/{owner}/{repo}/actions/runs/{run_id}/cancel`

## Request

- Base URL: `http://HOSTNAME/api/v3`
- URL: `http://HOSTNAME/api/v3/repos/{owner}/{repo}/actions/runs/{run_id}/cancel`
- Auth: none declared

Cancels a workflow run using its `id`.

OAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.

## Path parameters

- `owner` string, required
- `repo` string, required
- `run_id` integer, required

## Response `202`

Response

- EmptyObject: An object without any properties.

## Other responses

- `409`: Conflict

---

[API](https://skmtc.dev/github/apis/enterprise-server.md) · [All operations](https://skmtc.dev/github/apis/enterprise-server/llms.txt) · [OpenAPI document](https://skmtc.dev/github/apis/enterprise-server/revisions/5438365412fe?raw)