---
title: "Delete Domain"
method: DELETE
path: "/v0/pods/{pod_id}/domains/{domain_id}"
tags: ["pods > domains"]
---

# Delete Domain

`DELETE /v0/pods/{pod_id}/domains/{domain_id}`

## Request

- Base URL: `https://api.agentmail.to`
- URL: `https://api.agentmail.to/v0/pods/{pod_id}/domains/{domain_id}`
- Auth: HTTP bearer

**CLI:**
```bash
agentmail pods domains delete --pod-id <pod_id> --domain-id <domain_id>
```

## Path parameters

- `pod_id` string, required: ID of pod.
- `domain_id` string, required: The ID of the domain.

## Response `200`

Successful response

## Other responses

- `404`: Error response with status 404

## Changes

- **2026-10-16** `3f5c7830c952`: 1 breaking, 5 info
  - removed the success response with the status `204`
  - the endpoint scheme security `Bearer` was added to the API
  - the endpoint scheme security `BearerAuth` was removed from the API
  - api tag `pods > domains` added
  - …2 more
- **2026-07-15** `394ddcdd9c29`: 3 info
  - added the optional property `code` to the response with the `404` status
  - added the optional property `docs` to the response with the `404` status
  - added the optional property `fix` to the response with the `404` status

[Operation history](https://skmtc.dev/agentmail-to/apis/api/changes/v0/pods/:pod_id/domains/:domain_id/delete.md)

---

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