---
title: "Cancel Run"
method: POST
path: "/api/v1/leads/discover/runs/{run_id}/cancel"
tags: ["leads"]
---

# Cancel Run

`POST /api/v1/leads/discover/runs/{run_id}/cancel`

## Request

- Base URL: `https://api.nudgelink.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nudgelink.co/api/v1/leads/discover/runs/{run_id}/cancel`
- Auth: HTTP bearer

Cancel an in-flight discovery run (P0-1).

Client-scoped and idempotent. Queued work is revoked and marked cancelled
immediately. An active worker observes the cancellation signal, commits
confirmed partial results and releases the single-run lock when it exits.
While that worker owns the row, this endpoint can still return ``running``.
Already-terminal runs are returned unchanged.

## Path parameters

- `run_id` string, uuid, required

## Response `200`

Successful Response

- RunOut
  - `id` string, uuid, required
  - `status` string, required
  - `target_limit` integer, required
  - `score_threshold` integer, required
  - `searched_count` integer, required
  - `scored_count` integer, required
  - `suggested_count` integer, required
  - `credits_used` integer, required
  - `queries_used` object[], nullable, required
  - `filters_used` object, nullable
  - `score_distribution` object, nullable
  - `funnel` object, nullable
  - `failure_reason` string, nullable, required
  - `created_at` string, date-time, required
  - `completed_at` string, date-time, nullable, required
  - `discovery_mode` string
  - `enriched_count` integer
  - `can_run_again` boolean

## Other responses

- `422`: Validation Error

---

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