# Delete Domain

> Delete Domain is a free API for AI agents from AgentMail at mpp.api.agentmail.to, Free, status unknown (last checked 2026-10-12).

Permanently deletes a custom email domain from a specified AgentMail pod

## Facts

- Endpoint: DELETE https://mpp.api.agentmail.to/v0/pods/:pod_id/domains/:domain_id?utm_source=zero.xyz
- Price: Free
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Provider: AgentMail
- Docs: https://docs.agentmail.to
- Website: https://agentmail.to
- Tags: email, inboxes, domains, drafts, threads, webhooks, messaging, ai, social
- Canonical page: https://www.zero.xyz/c/agentmail-domain-id-6b397c43
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sSRPyUH50xZlRKlfzC3wr

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentmail-domain-id-6b397c43 -d '<json body>'
```

Example prompt: Delete the domain acme-corp.com from my AgentMail pod pod_abc123 — I no longer need it and want it fully removed.

## When to prefer this

Use this endpoint when you need to permanently remove a custom email domain from an AgentMail pod, such as when decommissioning an agent environment, rotating domains, or cleaning up unused infrastructure. Prefer this over simply disabling or archiving when the domain and all associated routing should be fully torn down.

## Known failure modes

- Domain not found (404) if domain_id does not exist in the given pod
- Pod not found (404) if pod_id is invalid or inaccessible
- Unauthorized (401) if the Bearer token is missing or invalid
- Forbidden (403) if the caller does not have permission to manage this pod's domains
- Conflict or dependency error if the domain has active inboxes or resources that prevent deletion

## How this service works

Delete Domain

## Output

A successful deletion returns an empty or confirmation response indicating the domain has been removed from the specified pod. Subsequent requests referencing this domain_id will return not-found errors.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "pod_id",
  "domain_id"
 ],
 "properties": {
  "pod_id": {
   "type": "string",
   "title": "PodId",
   "description": "ID of pod."
  },
  "domain_id": {
   "type": "string",
   "title": "DomainId",
   "description": "The name of the domain. (e.g., \" your-domain.com\")"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentmail-domain-id-6b397c43/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mpp.api.agentmail.to](https://www.zero.xyz/host/mpp.api.agentmail.to/llms.txt)