---
title: "Cancel a scheduled message"
method: DELETE
path: "/v1/emails/{id}"
tags: ["Emails"]
---

# Cancel a scheduled message

`DELETE /v1/emails/{id}`

## Request

- Base URL: `https://api.volanea.com`
- URL: `https://api.volanea.com/v1/emails/{id}`
- Auth: HTTP bearer

Stops a message that was queued with `sendAt` before it is dispatched. Only a `queued` message that actually has a `scheduledFor` can be cancelled: one sent immediately answers 409 `not_scheduled`, and one already dispatched answers 409 `already_dispatched`. Cancelling emits an `email.cancelled` event.

## Path parameters

- `id` string, required

## Response `200`

The cancelled message.

- object
  - `emailId` string, required
  - `status` 'cancelled', required

## Other responses

- `401`: Missing or invalid API key.
- `404`: Not found.
- `409`: Not scheduled, or already dispatched.

---

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