---
title: "Release a hostname"
method: DELETE
path: "/v1/hostnames/{id}"
tags: ["hostnames"]
---

# Release a hostname

`DELETE /v1/hostnames/{id}`

## Request

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

Releases the hostname. The DNS record stops being served and any certificate we hold for it is revoked. The name is free immediately: POST the same subdomain again to take it back, which mints a new hostname with a new id. Releasing an already released hostname returns the same success response.

## Response `200`

The hostname was released.

- ReleaseResult
  - `released` true, required

## Other responses

- `401`: The Authorization header is missing, malformed, or the key is unknown or revoked.
- `403`: The hostname is suspended pending an abuse review and cannot be released.
- `404`: No hostname with this id belongs to the authenticated account.
- `409`: The hostname was terminated for policy violation and cannot be released.
- `500`: Unexpected server error.

---

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