---
title: "Cancel Delivery"
method: POST
path: "/relay/delivery/{reference}/cancel"
tags: ["Relay Delivery"]
---

# Cancel Delivery

`POST /relay/delivery/{reference}/cancel`

Cancel an active relay delivery. A cancellation reason is required.

## Path parameters

- `reference` string, required

## Request body

- object
  - `reason` string, required — The reason for cancelling the delivery.

## Response `200`

Delivery cancelled successfully.

- object
  - `status` string
  - `message` string

## Other responses

- `400` — Bad request — missing reference or reason, or the delivery cannot be cancelled at its current status.
- `404` — Delivery not found for the given reference.

---

[API](https://skmtc.dev/chowdeck/apis/chowdeck-api.md) · [All operations](https://skmtc.dev/chowdeck/apis/chowdeck-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chowdeck/chowdeck-api/revisions/5830cc8467d8/schema)