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

# Force cancel a workflow run

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

Cancels a workflow run and bypasses conditions that would otherwise cause a workflow execution to continue, such as an `always()` condition on a job.
You should only use this endpoint to cancel a workflow run when the workflow run is not responding to [`POST /repos/{owner}/{repo}/actions/runs/{run_id}/cancel`](/rest/actions/workflow-runs#cancel-a-workflow-run).

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.net/github/apis/api-github-com.md) · [All operations](https://skmtc.net/github/apis/api-github-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/api-github-com/revisions/a367f7028301/schema)