SDK / API ReferenceMessages
Delete Message
Soft-delete a message
Scope: mail:manage
Soft-delete a message from the inbox. The message no longer appears in list results.
Request
import { Mailgent } from "@mailgent/sdk";
const mailgent = new Mailgent({ apiKey: process.env.MAILGENT_API_KEY! });
await mailgent.mail.deleteMessage("<abc123@gmail.com>");import os
from mailgent import Mailgent
mailgent = Mailgent(api_key=os.environ["MAILGENT_API_KEY"])
mailgent.mail.delete_message("<abc123@gmail.com>")mailgent mail delete '<abc123@gmail.com>'Quote the messageId — it contains <>@ characters your shell will otherwise interpret.
mail.delete_message(message_id)Available through @mailgent/mcp — see MCP setup.
curl -X DELETE https://api.mailgent.dev/v0/messages/%3Cabc123%40gmail.com%3E \
-H "Authorization: Bearer loid-your-api-key"Path Parameters
| Param | Type | Description |
|---|---|---|
messageId | string | The message ID to delete |
Response — 204 No Content
No body.
Errors
| Status | Code | Description |
|---|---|---|
404 | not_found | Message not found or not accessible |