---
title: "Retire an alias."
method: DELETE
path: "/v1/addresses/{id}"
tags: ["Addresses"]
---

# Retire an alias.

`DELETE /v1/addresses/{id}`

## Request

- Base URL: `https://api.inboxy.net`
- URL: `https://api.inboxy.net/v1/addresses/{id}`
- Auth: HTTP bearer

Requires `manage` scope. Stops accepting new mail; existing messages remain visible.

## Path parameters

- `id` string, uuid, required

## Response `204`

Retired.

## Other responses

- `403`: Token lacks the required scope.
- `404`: No matching resource owned by the caller.

---

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