# Delete List Entry

> Delete List Entry is a free API for AI agents from AgentMail at mpp.api.agentmail.to, Free, status unknown (last checked 2026-10-10).

Removes a specific email address or domain from an inbox's allow or block list for a given message direction

## Facts

- Endpoint: DELETE https://mpp.api.agentmail.to/v0/inboxes/:inbox_id/lists/:direction/:type/:entry?utm_source=zero.xyz
- Price: Free
- Status: unknown
- Last checked: 2026-10-10
- 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-entry-f00b8585
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h4henBPezEPSXiUAPV05P

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

Example prompt: Remove the email address 'spam@example.com' from the receive blocklist for inbox 'inbox_abc123' in AgentMail.

## When to prefer this

Use this endpoint when you need to revoke a previously created allow or block list rule for a specific inbox. Choose this when an email address or domain should no longer be filtered for a particular message direction. This is the correct endpoint when you want to undo a list entry created via the Create List Entry endpoint.

## Known failure modes

- Entry not found — the specified email or domain does not exist in the list (404)
- Invalid inbox_id — the inbox does not exist or is not accessible (404)
- Invalid direction value — must be one of: send, receive, reply (422)
- Invalid type value — must be one of: allow, block (422)
- Unauthorized — missing or invalid Bearer token (401)
- Entry format invalid — provided entry is not a valid email or domain format (400)

## How this service works

Delete List Entry

## Output

A confirmation that the specified email address or domain has been deleted from the inbox's allow or block list for the given direction (send, receive, or reply). Typically returns an empty success response or a confirmation object.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "inbox_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."
  },
  "inbox_id": {
   "type": "string",
   "title": "InboxId",
   "description": "The ID of the inbox."
  },
  "direction": {
   "enum": [
    "send",
    "receive",
    "reply"
   ],
   "type": "string",
   "title": "Direction",
   "description": "Direction of list entry."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentmail-entry-f00b8585/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)