---
title: "Cancel Run"
method: POST
path: "/v1/evals/{eval_id}/runs/{run_id}"
tags: ["evals"]
---

# Cancel Run

`POST /v1/evals/{eval_id}/runs/{run_id}`

Cancel a running run.

Model-based routing (for multi-account support):
- Pass model via header: `x-litellm-model: gpt-4-account-1`
- Pass model via query: `?model=gpt-4-account-1`

Example usage:
```bash
curl -X POST "http://localhost:4000/v1/evals/eval_123/runs/run_456/cancel"       -H "Authorization: Bearer your-key"
```

Returns: CancelRunResponse with cancellation confirmation

## Path parameters

- `eval_id` string, required
- `run_id` string, required

## Query parameters

- `custom_llm_provider` string, nullable

## Response `200`

Successful Response

- CancelRunResponse — Response from cancelling a run
  - `id` string, required
  - `object` string
  - `status` 'cancelled', required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-19** `c357baf422ab` — 2 info
  - api tag `evals` added
  - api tag `OpenAI Evals API - Runs` removed
- **2026-09-18** `082b5fabd909` — 4 info
  - api tag `OpenAI Evals API - Runs` added
  - api tag `evals` removed
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Change history](https://skmtc.dev/flock/apis/litellm-api/changes/v1/evals/:eval_id/runs/:run_id/post.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flock/apis/litellm-api/revisions/731afbea6a1b?raw)