---
title: "Cancel a queued or scheduled message"
method: DELETE
path: "/v1/api/messages/{messageId}"
tags: ["Messages"]
---

# Cancel a queued or scheduled message

`DELETE /v1/api/messages/{messageId}`

Request cancellation for a queued or scheduled message. If the message is already in a non-cancellable state (e.g., sent), the response indicates the current status. Note: response may include deprecated `current_status`; use `status` instead.

## Response `200`

Cancellation initiated or message already in non-cancellable state.

- CancellationResponse
  - `message_id` string
  - `cancelled` boolean — True if cancellation was successful, false otherwise.
  - `status` string — The current status of the message.
  - `current_status` string, nullable — The current status if cancellation failed (deprecated, use 'status' instead).
  - `message` string — Human-readable message about the cancellation result.

## Other responses

- `401` — Invalid or missing API key.
- `404` — Resource not found.
- `409` — Message could not be cancelled (already sent or failed).

---

[API](https://skmtc.dev/blooio/apis/blooio-messaging-api-v3.md) · [All operations](https://skmtc.dev/blooio/apis/blooio-messaging-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/blooio/blooio-messaging-api-v3/revisions/2d1e4d94ef5b/schema)