{"uid":"cap_1sxv0JimEe4xhJJ4KXg4p","slug":"agentmail-entry-85d5af55","name":"Delete List Entry","description":"Delete List Entry","url":"https://mpp.api.agentmail.to/v0/pods/:pod_id/lists/:direction/:type/:entry?utm_source=zero.xyz","method":"DELETE","headers":{},"bodySchema":{"type":"object","required":["pod_id","direction","type","entry"],"properties":{"type":{"enum":["allow","block"],"type":"string","title":"ListType","description":"Type of list entry."},"entry":{"type":"string","description":"Email address or domain."},"pod_id":{"type":"string","title":"PodId","description":"ID of pod."},"direction":{"enum":["send","receive","reply"],"type":"string","title":"Direction","description":"Direction of list entry."}}},"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":"Removes a specific email address or domain from an allow or block list for a given pod and direction in AgentMail.","exampleAgentPrompt":"Remove 'spammer@example.com' from the receive block list for pod 'pod_abc123' in AgentMail so it's no longer filtered out.","exampleUseCases":[{"title":"Unblock a trusted vendor email","prompt":"We need to whitelist invoices@vendor.com again for our accounting team. Can you remove it from the block list for pod_finance so they start receiving those emails?"},{"title":"Clean up old domain filtering rules","prompt":"Our old partner company changed their domain from oldpartner.com to newpartner.com. Please delete oldpartner.com from the send allow list for pod_partnerships so we can update our filtering."},{"title":"Revoke access for a former contact","prompt":"One of our team members left the company. Take them off the reply allow list for pod_support since they shouldn't be getting those internal conversation threads anymore."}],"resultDescription":"A confirmation that the specified email address or domain has been deleted from the designated allow or block list for the given pod and direction. Typically returns a 200 or 204 status with no or minimal body content on success.","failureModes":["Pod ID not found — 404 error","Entry not found in the specified list — 404 error","Invalid direction value (not send/receive/reply) — 400 validation error","Invalid list type (not allow/block) — 400 validation error","Unauthorized — missing or invalid Bearer token returns 401","Entry string malformed (not a valid email or domain) — 400 error"],"whenToPreferThis":"Use this endpoint when you need to remove a previously created allow or block list entry for a specific pod in AgentMail. This is the right choice when cleaning up filtering rules, unblocking a contact, or revoking a whitelist entry for a specific email direction (send, receive, or reply).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:41:11.141Z","isFirstParty":false,"canonicalSlug":"agentmail-entry-f00b8585"}