This method is used to delete a message from a folder.
When a message is deleted, it's normally moved to a Trash folder and then a Deleted Trash folder before being permanently purged from the DataMotion account.
The trash deletion mechanism is controlled by the DataMotion Server.
Deleting a message only removes the message from the current user’s account.
It does not remove the message from the account of any other DataMotion users referenced in the message.
A session key must be submitted via the X-Session-Key header.
The request body should be left empty.
The message ID of the message you'd like to delete must be passed in the URL of this method.
Include "?Permanently=true" to force a message to be permanently deleted from the account, bypassing any Trash folders.
A successful transaction will receive a 200 status code.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
The X-Session-Key header is missing. ||
Bad session key. ||
Session key expired. ||
Could not parse the message ID into an integer. ||
You do not have access to message with id [MessageId]. ||
Message could not be moved to the recovery folder. ||
Message could not be moved to the trash folder. ||
The message has been deleted from the Inbox and is no longer available. ||
This message has been deleted from Track Sent and is no longer available. ||
Message could not be permanently deleted from the user's account.