Skip to main content
DELETE
Delete Thread
Permanently deletes a thread and every message in it. Returns no body. This cannot be undone and it removes more than one message — Every AIsa caller shares one AgentMail account, so this reaches inboxes other callers created, so read the thread with get_agentmail_inbox_thread first. To hide it instead, relabel with patch_agentmail_inbox_thread.

Example

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.
Set this endpoint up in your agent →

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Authorization
string
required

Bearer authentication

Path Parameters

inbox_id
string
required

The ID of the inbox.

thread_id
string
required

ID of thread.

Query Parameters

permanent
boolean

If true, permanently delete the thread instead of moving to trash.

Response

Successful response