---
title: "Cancel Run"
method: POST
path: "/v1/jobs/runs/{run_id}/cancel"
tags: ["Jobs"]
deprecated: true
---

# Cancel Run

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

## Request

- Base URL: `https://sdk.nimbleway.com`
- URL: `https://sdk.nimbleway.com/v1/jobs/runs/{run_id}/cancel`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `token`

> **Deprecated.**

Cancel Run

## Path parameters

- `run_id` string, required

## Response `200`

Successful Response

- JobRunCancelResponsePublicV1: Result of cancelling a run.
  - `id` string, required: Identifier of the cancelled run.
  - `status` 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILED' | 'CANCELLED' | 'TIMEOUT' | 'WARNING', required: Run status after cancellation.

## Other responses

- `422`: Validation Error

## Changes

- **2026-07-20** `d4e4f170f4f4`: 1 warning, 4 info
  - deleted the `cookie` request parameter `token`
  - api operation id `cancel_run_v2_jobs_runs__run_id__cancel_post` removed and replaced with `cancel_run_public_v1_api_v1_public_jobs_runs__run_id__cancel_post`
  - the endpoint scheme security `APIKeyCookie` was added to the API
  - the endpoint scheme security `HTTPBearer` was added to the API
  - …1 more
- **2026-06-18** `2562e655b8f2`: 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/nimbleway/apis/api-gateway.md) - [All operations](https://skmtc.dev/nimbleway/apis/api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/nimbleway/apis/api-gateway/revisions/167c81181daa?raw)