Delete a Message

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.

Path Params
string
required

Unique message identifier

Query Params
boolean

Indicates whether or not to force a message to be permanently deleted from the account, bypassing any Trash folders

Headers
string
Responses

401

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.

Language
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json