---
title: "Cancel a purchased pre-warmed domain"
method: POST
path: "/v1/prewarmed/cancel"
tags: ["Pre-warmed Marketplace"]
---

# Cancel a purchased pre-warmed domain

`POST /v1/prewarmed/cancel`

## Request

- Base URL: `https://api.winnr.app`
- URL: `https://api.winnr.app/v1/prewarmed/cancel`
- Auth: HTTP bearer

Ends billing for a pre-warmed domain and returns it to inventory. There is
no minimum term — cancellation is available at any time.

This deletes the domain and its mailboxes from your account and reduces the
recurring pre-warmed quantity. Deleting a pre-warmed domain from
`DELETE /v1/domains/{domain_id}` runs this same path — for pre-warmed
domains, deletion *is* cancellation.

## Request body

- PrewarmedCancelRequest
  - `domain` string, required

## Response `200`

Domain cancelled and returned to inventory

- PrewarmedCancelResponse
  - `data` object
    - `status` 'returned'
    - `domain` string
    - `removed_addresses` integer: Mailboxes removed from your account.
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `400`: The request was invalid (e.g. malformed domain).
- `401`: Authentication required or token invalid
- `403`: The domain is not associated with your account.
- `404`: Resource not found

---

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