---
title: "Cancel local runner authority"
method: POST
path: "/v1/automation-runs/{run_id}/cancel"
tags: ["Automation"]
---

# Cancel local runner authority

`POST /v1/automation-runs/{run_id}/cancel`

## Request

- Base URL: `https://api.agentry.sh`
- URL: `https://api.agentry.sh/v1/automation-runs/{run_id}/cancel`
- Auth: HTTP bearer

Owner-only atomic cancellation of the run, claim, pending approvals, and issued grants. External provider effects are not cancelled and may require explicit follow-up.

## Path parameters

- `run_id` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `reason` string, required

## Response `200`

OK

- object
  - `run_id` string, required
  - `status` 'cancelled', required
  - `reason` string, required
  - `cancelled_by` string, required
  - `cancelled_at` integer, required
  - `idempotent_replay` boolean, required
  - `external_follow_up` object
    - `required` true, required
    - `provider_state` 'unknown', required
    - `external_effect_cancelled_by_agentry` false, required
    - `evidence` object, required
      - `pr_url` string, uri, nullable, required: Absolute HTTPS URL without embedded username or password credentials.
      - `pr_proof_recorded` boolean, required
      - `deploy_sha` string, nullable, required
      - `action_grant_statuses` string[], required
    - `next_action` string, required
  - `next_action` string, required

## Other responses

- `default`: Error

---

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