Delete message
DELETE/v1/account/:account/message/:message
Move message to Trash or delete it if already in Trash
For Gmail API accounts the message is always moved to Trash. The force option, which permanently deletes on IMAP accounts, has no effect.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 429
- 500
- 503
Returns whether the message was moved to Trash or permanently deleted.
Invalid input - the path parameters, query arguments, or request payload did not pass validation
Authentication failed - the access token is missing, invalid, or was not accepted
Access denied - the access token does not grant permission for this operation (token scope, account, or IP address restriction)
Not found - the requested entity (account, message, mailbox, etc.) does not exist
Rate limit exceeded - too many requests were made with this access token
Internal server error - an unexpected error occurred while processing the request
Service unavailable - the worker processing this account is not available, try again later