# 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 specified email domain from AgentMail

## Facts

- Endpoint: DELETE https://mpp.api.agentmail.to/v0/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-df7f5616
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_weVsPvJalWzsqNhMAGGwT

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-df7f5616 -d '<json body>'
```

Example prompt: Delete the domain example-agents.com from my AgentMail account — I no longer need it.

## When to prefer this

Use this endpoint when you need to permanently remove a custom email domain from AgentMail, such as when decommissioning an agent, cleaning up test domains, or retiring a brand. Prefer this over simply abandoning a domain to ensure proper cleanup of routing and inbox configurations.

## Known failure modes

- domain_id not found — returns 404 if the specified domain does not exist
- missing or invalid Authorization header — returns 401 unauthorized
- domain_id is malformed or empty — returns 400 bad request
- domain is still in use with active inboxes — may return 409 conflict

## How this service works

Delete Domain

## Output

A confirmation that the specified domain has been permanently deleted from AgentMail, removing it and any associated inboxes or routing configurations.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "domain_id"
 ],
 "properties": {
  "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-df7f5616/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)