---
title: "Cancel message"
method: POST
path: "/messages/{message_id}/cancel"
tags: ["Messages"]
---

# Cancel message

`POST /messages/{message_id}/cancel`

Cancels a message that is still in the delivery pipeline and returns the message record with its resulting canceled or failed status.

## Path parameters

- `message_id` string, required

## Response `200`

- MessageDetails
  - `id` string, required — A unique identifier associated with the message you wish to retrieve (results from a send).
  - `status` 'CANCELED' | 'CLICKED' | 'DELAYED' | 'DELIVERED' | 'DIGESTED' | 'ENQUEUED' | 'FILTERED' | 'OPENED' | 'ROUTED' | 'SENT' | 'SIMULATED' | 'THROTTLED' | 'UNDELIVERABLE' | 'UNMAPPED' | 'UNROUTABLE', required
  - `enqueued` integer, required — A UTC timestamp at which Courier received the message request. Stored as a millisecond representation of the Unix epoch.
  - `sent` integer — A UTC timestamp at which Courier passed the message to the Integration provider. Stored as a millisecond representation of the Unix epoch.
  - `delivered` integer — A UTC timestamp at which the Integration provider delivered the message. Stored as a millisecond representation of the Unix epoch.
  - `opened` integer — A UTC timestamp at which the recipient opened a message for the first time. Stored as a millisecond representation of the Unix epoch.
  - `clicked` integer — A UTC timestamp at which the recipient clicked on a tracked link for the first time. Stored as a millisecond representation of the Unix epoch.
  - `recipient` string, required — A unique identifier associated with the recipient of the delivered message.
  - `event` string, required — A unique identifier associated with the event of the delivered message.
  - `notification` string, required — A unique identifier associated with the notification of the delivered message.
  - `error` string, nullable — A message describing the error that occurred.
  - `reason` 'BOUNCED' | 'FAILED' | 'FILTERED' | 'NO_CHANNELS' | 'NO_PROVIDERS' | 'OPT_IN_REQUIRED' | 'PROVIDER_ERROR' | 'UNPUBLISHED' | 'UNSUBSCRIBED'

---

[API](https://skmtc.net/trycourier/apis/courier.md) · [All operations](https://skmtc.net/trycourier/apis/courier/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trycourier/courier/versions/04f69fbf96a5/schema)