{"uid":"cap_weVsPvJalWzsqNhMAGGwT","slug":"agentmail-domain-id-df7f5616","name":"Delete Domain","description":"Delete Domain","url":"https://mpp.api.agentmail.to/v0/domains/:domain_id?utm_source=zero.xyz","method":"DELETE","headers":{},"bodySchema":{"type":"object","required":["domain_id"],"properties":{"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 specified email domain from AgentMail","exampleAgentPrompt":"Delete the domain example-agents.com from my AgentMail account — I no longer need it.","exampleUseCases":[{"title":"Retiring a brand email domain","prompt":"Remove the marketing-emails.acme.com domain from AgentMail completely — we're consolidating to our main company domain next month."},{"title":"Cleaning up test and staging domains","prompt":"Delete all our test domains like sandbox.company.com and staging-mail.company.com from AgentMail now that we're going live."},{"title":"Decommissioning agent fleet infrastructure","prompt":"Take down the support-agents.oldcompany.com domain from my AgentMail setup since we've shut down that customer service operation."}],"resultDescription":"A confirmation that the specified domain has been permanently deleted from AgentMail, removing it and any associated inboxes or routing configurations.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:44:17.185Z","isFirstParty":false,"canonicalSlug":"agentmail-domain-id-df7f5616"}