{"uid":"cap_sSRPyUH50xZlRKlfzC3wr","slug":"agentmail-domain-id-6b397c43","name":"Delete Domain","description":"Delete Domain","url":"https://mpp.api.agentmail.to/v0/pods/:pod_id/domains/:domain_id?utm_source=zero.xyz","method":"DELETE","headers":{},"bodySchema":{"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\")"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["email","inboxes","domains","drafts","threads","webhooks","messaging","ai","social"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"unknown","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":null,"accepted":[]},"paymentMethods":[],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Permanently deletes a custom email domain from a specified AgentMail pod","exampleAgentPrompt":"Delete the domain acme-corp.com from my AgentMail pod pod_abc123 — I no longer need it and want it fully removed.","exampleUseCases":[{"title":"Clean up decommissioned agent environment domains","prompt":"We're shutting down our test agent pod and need to remove all custom domains we set up for it. Please delete support-test.acme.com from pod_test_env — we won't be using it anymore."},{"title":"Rotate email domain for security purposes","prompt":"We're rotating our agent email domain for security reasons. Can you delete our old domain old-agent.acme.com from pod_prod_agents so it stops receiving any new messages and we can fully switch over to our new domain?"},{"title":"Remove unused domains from active pods","prompt":"We have a few email domains in our AgentMail pod that we created but never ended up using. Please delete unused-domain.acme.com from pod_main — it's just cluttering our setup and we want a clean slate."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:39:40.271Z","isFirstParty":false,"canonicalSlug":"agentmail-domain-id-df7f5616"}