Mail

Delete a message

Moves the message to Trash. Set permanent=true to delete permanently. Requires scope mail:write.

delete/mailboxes/{address}/messages/{uid}

Request

  • Base URL: https://faivelo.com/api/v1
  • URL: https://faivelo.com/api/v1/mailboxes/{address}/messages/{uid}
  • Auth: HTTP bearer

Path parameters

addressstring required

Full mailbox address, e.g. user@yourdomain.com

integer required
OR
string required

The message: its IMAP UID (an integer, as returned by the list endpoint; relative to folder), or the permanent message_id from a message.received / message.sent webhook, which stays the same when the message moves. Add ?id=permanent to force the second reading of an all-digit id.

Query parameters

folderstring

IMAP folder name (defaults to INBOX)

permanentboolean

Skip Trash and permanently delete

Response

Message deleted

successboolean

Example response

{
  "success": true,
  "data": {
    "deleted": true
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.