---
title: "Cancel Op"
method: POST
path: "/infra/operations/{operation_id}/cancel"
tags: ["infra-operations"]
---

# Cancel Op

`POST /infra/operations/{operation_id}/cancel`

## Request

- Base URL: `https://api.4chems.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.4chems.com/infra/operations/{operation_id}/cancel`
- Auth: HTTP bearer

Cancel a pending or running operation and return its new status. Call this
when an operator wants to stop an operation that should no longer proceed.

## Path parameters

- `operation_id` string, uuid, required

## Response `200`

Successful Response

- OperationInfraOut: Full detail schema for the /infra operations console (UC-022). Intentionally excludes idempotency_key — it is a caller secret.
  - `operation_id` string, uuid, required
  - `status` string, required
  - `type` string, required
  - `tier` string, required
  - `tenant` string, nullable
  - `actor_sub` string, required
  - `target_type` string, nullable
  - `target_id` string, nullable
  - `result` unknown
  - `error` ErrorDetail
    - `code` string, required
    - `message` string, required
  - `attempts` integer, required
  - `max_attempts` integer, required
  - `cancel_requested` boolean, required
  - `retried_by` string, nullable
  - `cancelled_by` string, nullable
  - `locked_until` string, date-time, nullable
  - `created_at` string, date-time, required
  - `started_at` string, date-time, nullable
  - `finished_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/4chems/apis/platform-api.md) · [All operations](https://skmtc.dev/4chems/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/4chems/apis/platform-api/revisions/65e4f7b4dba0?raw)