Remove one email from the history of a site
delete_site_email_send
Removes one email from a site's history, without unsending it or changing this month's allowance.
The email disappears from list_site_email_sends, the stats, the Emails tab and the site's own getEmail and listEmails, and it is erased for good 30 days later. The email itself was already sent and stays sent, and this month's allowance does not change.
It needs the Delete projects permission. See Open an email.
Request
Call it with a POST to https://api.modulify.ai/v1/delete_site_email_send, sending the inputs below as a JSON object. The token needs the config:write scope.
This method is marked destructive: it deletes or overwrites data. Check the inputs before you call it, and send an Idempotency-Key header whenever you might retry it.
curl -X POST https://api.modulify.ai/v1/delete_site_email_send \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"projectId":"PROJECT_ID","sendId":"SEND_ID"}'Over MCP, the same method is the delete_site_email_send tool.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
projectId |
string | Yes | The site id. |
sendId |
string | Yes | The id of the email, from list_site_email_sends. |
Response
Every call answers with the JSON envelope of success, message, data, code and version. data holds the result described above, and on a method that returns a total, count carries it. The response headers carry the call's X-Request-Id and what is left of your per-minute budget in X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Errors explains every status code a call can answer with.