Buttondown logo

Deleting an email

Delete an email from your Buttondown account. Deleting an email will:

  • Remove the email from your archive (if it was published)
  • Scrub any references to the email from related emails
  • Delete any associated comments, social mentions, and other related data
  • Cancel any scheduled sends associated with the email

Note that deleted emails cannot be recovered, so be sure this is what you want to do before proceeding.

Sample requests

These sample requests are autogenerated by the OpenAPI spec. This endpoint requires one or more parameters in the URL: those are offset in curly-braces.

import requests

url = "https://api.buttondown.com/v1/emails/{id}"
headers = {
  "Authorization": "Token $BUTTONDOWN_API_KEY"
}

response = requests.request("DELETE", url, headers=headers)
print(response.text)

Sample responses

The IDs and values referenced in these responses are fake; please only rely on these responses for overall structure.

{}