Delete messages

PUT 
/v1/account/:account/messages/delete

Move messages to Trash or delete these 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

Returns the number of messages deleted.

400

Invalid input - the path parameters, query arguments, or request payload did not pass validation

401

Authentication failed - the access token is missing, invalid, or was not accepted

403

Access denied - the access token does not grant permission for this operation (token scope, account, or IP address restriction)

404

Not found - the requested entity (account, message, mailbox, etc.) does not exist

429

Rate limit exceeded - too many requests were made with this access token

500

Internal server error - an unexpected error occurred while processing the request

503

Service unavailable - the worker processing this account is not available, try again later