> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Delete Inbox List Entry
> Removes one entry from an inbox's allow or block list.
Removes one entry from an inbox's allow or block list. Returns no body. This changes what the inbox will accept or send from that point on. Entries whose `read_only` is true are platform managed and cannot be removed — check with `get_agentmail_inbox_list_entry` first. Writes to the shared AgentMail workspace: Every AIsa caller shares one AgentMail account, so this reaches inboxes other callers created, and what you write here is visible and editable by the next caller.
## Example
```bash REST theme={null}
curl -X DELETE "https://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/lists/{direction}/{type}/{entry}" \
-H "Authorization: Bearer YOUR_API_KEY"
```
```jsonc MCP theme={null}
// Copy this whole block into Claude Code, Codex, Cursor or any coding agent.
// It carries everything needed to connect, authorize and run this example —
// no key to paste, one click of Allow in the browser.
{
"operation_id": "delete_agentmail_inbox_list_entry",
"arguments": {},
"max_price_usd": 0.05
}
// ── for the agent ─────────────────────────────────────────────────────────
// Register the AIsa MCP server, then call its `use` tool with the JSON above.
// name aisa
// endpoint https://mcp.aisa.one/mcp
// transport streamable-http
// auth OAuth. The server publishes RFC 9728 metadata, so open a
// browser and the user clicks Allow once — nothing to paste.
// If AISA_API_KEY is set, send it as a bearer header instead.
// Use your own MCP mechanism, not a hand-edited config file:
// Codex codex mcp add aisa --url https://mcp.aisa.one/mcp
// Claude Code claude mcp add --transport http -s user aisa https://mcp.aisa.one/mcp
// Cursor / VS Code a "url" entry for https://mcp.aisa.one/mcp in the MCP config
// The server lists five tools over https://mcp.aisa.one/servers worth of APIs:
// search, get_details, use, batch_use, list_categories. search and
// get_details are free; use is billed per call and max_price_usd refuses
// anything above the cap before spending. This operation's full contract —
// every argument, the response shape, the price and the pitfalls — is at
// https://aisa.one/docs/api-reference/agentmail/delete_agentmail-inboxes-inbox-id-lists-direction-type-entry.md
// Then run the call and show me the result.
```
**First time?** Point any MCP client at `https://mcp.aisa.one/mcp` — Claude
Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client
opens a browser, you click Allow once, and there is no key to paste. The
commands per client, and what each call costs, are on
[aisa.one/mcp](https://aisa.one/mcp#connect).
[Set this endpoint up in your agent →](https://aisa.one/mcp?from=/api-reference/agentmail/delete_agentmail-inboxes-inbox-id-lists-direction-type-entry)
## OpenAPI
````yaml openapi/agentmail.json DELETE /agentmail/inboxes/{inbox_id}/lists/{direction}/{type}/{entry}
openapi: 3.1.0
info:
title: AgentMail API
version: 1.0.0
description: >-
AgentMail email API endpoints exposed through the AIsa unified gateway.
Adapted from the upstream docs.agentmail.to OpenAPI spec.
servers:
- url: https://api.aisa.one/apis/v1
security:
- Bearer: []
paths:
/agentmail/inboxes/{inbox_id}/lists/{direction}/{type}/{entry}:
delete:
tags:
- subpackage_inboxes.subpackage_inboxes/lists
summary: Delete Inbox List Entry
description: >-
Removes one entry from an inbox's allow or block list. Returns no body.
This changes what the inbox will accept or send from that point on.
Entries whose `read_only` is true are platform managed and cannot be
removed — check with `get_agentmail_inbox_list_entry` first. Writes to
the shared AgentMail workspace: Every AIsa caller shares one AgentMail
account, so this reaches inboxes other callers created, and what you
write here is visible and editable by the next caller.
operationId: delete_agentmail_inbox_list_entry
parameters:
- name: inbox_id
in: path
required: true
schema:
$ref: '#/components/schemas/type_inboxes_InboxId'
- name: direction
in: path
required: true
schema:
$ref: '#/components/schemas/type_lists_Direction'
- name: type
in: path
required: true
schema:
$ref: '#/components/schemas/type_lists_ListType'
- name: entry
in: path
description: Email address or domain.
required: true
schema:
type: string
- name: Authorization
in: header
description: Bearer authentication
required: true
schema:
type: string
responses:
'200':
description: Successful response
'404':
description: Error response with status 404
content:
application/json:
schema:
$ref: '#/components/schemas/type__ErrorResponse'
components:
schemas:
type_inboxes_InboxId:
type: string
description: The ID of the inbox.
title: InboxId
type_lists_Direction:
type: string
enum:
- send
- receive
- reply
description: Direction of list entry.
title: Direction
type_lists_ListType:
type: string
enum:
- allow
- block
description: Type of list entry.
title: ListType
type__ErrorResponse:
type: object
properties:
name:
$ref: '#/components/schemas/type__ErrorName'
message:
$ref: '#/components/schemas/type__ErrorMessage'
required:
- name
- message
title: ErrorResponse
type__ErrorName:
type: string
description: Name of error.
title: ErrorName
type__ErrorMessage:
type: string
description: Error message.
title: ErrorMessage
securitySchemes:
Bearer:
type: http
scheme: bearer
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.