LOOMAL
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 { Loomal } from "@loomal/sdk";

const loomal = new Loomal({ apiKey: process.env.LOOMAL_API_KEY! });
await loomal.mail.deleteMessage("<abc123@gmail.com>");
import os
from loomal import Loomal

loomal = Loomal(api_key=os.environ["LOOMAL_API_KEY"])
loomal.mail.delete_message("<abc123@gmail.com>")
loomal mail delete '<abc123@gmail.com>'

Quote the messageId — it contains <>@ characters your shell will otherwise interpret.

mail.delete_message(message_id)

Available through @loomal/mcp — see MCP setup.

curl -X DELETE https://api.loomal.ai/v0/messages/%3Cabc123%40gmail.com%3E \
  -H "Authorization: Bearer loid-your-api-key"

Path Parameters

ParamTypeDescription
messageIdstringThe message ID to delete

Response — 204 No Content

No body.

Errors

StatusCodeDescription
404not_foundMessage not found or not accessible

On this page