{"uid":"cap_P7XqdvL4N-dlup8aciSwv","slug":"agentmail-inbox-id-8e27d67e","name":"AgentMail Delete Inbox","description":"Delete Inbox","url":"https://mpp.api.agentmail.to/v0/inboxes/:inbox_id?utm_source=zero.xyz","method":"DELETE","headers":{},"bodySchema":{"type":"object","required":["inbox_id"],"properties":{"inbox_id":{"type":"string","title":"InboxId","description":"The ID of the inbox."}}},"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":"unprobed","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 specific email inbox by its ID from the AgentMail platform","exampleAgentPrompt":"Delete the AgentMail inbox with ID inbox_abc123 — I no longer need it and want it permanently removed.","exampleUseCases":[{"title":"Clean up test agent inboxes","prompt":"We've finished testing our new customer support agent and no longer need the test inboxes. Can you permanently delete the inbox with ID inbox_test_phase2? We want to make sure all the test messages and data are completely gone."},{"title":"Decommission retired agent mailbox","prompt":"We're shutting down our old lead-qualification agent and need to clean up after it. Please permanently remove the inbox with ID inbox_lead_qual_v1 from AgentMail — we've already migrated everything important to the new system."},{"title":"Remove obsolete department inbox","prompt":"Our HR department switched email providers last month, so the AgentMail inbox with ID inbox_hr_agent is just sitting there unused now. Can you permanently delete it to clear out our account?"}],"resultDescription":"A confirmation that the inbox has been deleted. The inbox and all associated data (messages, threads, drafts) are permanently removed from the AgentMail platform.","failureModes":["Inbox ID not found — 404 error if the specified inbox_id does not exist","Unauthorized — 401 error if the Bearer token is missing or invalid","Inbox already deleted — attempting to delete a non-existent inbox returns an error","Permission denied — 403 if the authenticated user does not own the inbox"],"whenToPreferThis":"Use this endpoint when you need to permanently remove an AI agent email inbox from AgentMail and no longer require access to its messages or threads. Prefer this over archiving or disabling when the inbox is completely obsolete and cleanup is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:45:48.298Z","isFirstParty":false,"canonicalSlug":"agentmail-inbox-id-8e27d67e"}