API reference
Delete a message
Required scope: mailbox:manage.
DELETE
/v1/messages/{messageId}Authorization
tenantApiKey x-api-key<token>
A scoped tenant key returned once by an operator. Never place it in URLs, logs, prompts, or client-side application code.
In: header
Path Parameters
messageId*string
Match
^msg_[a-f0-9]{24}$Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
# Set the API key and replace resource IDs with your saved IDs.curl --fail-with-body --silent --show-error -X DELETE \ "https://api.mailactor.com/v1/messages/$MESSAGE_ID" \ -H "x-api-key: $MAILACTOR_API_KEY"Response examples
Illustrative values; save the IDs and limits returned by your own requests.
HTTP 204
No response body. Do not call response.json().