Skip to main content
DELETE
/
api
/
email
/
accounts
/
{id}
Delete Inbox
curl --request DELETE \
  --url https://app.puffle.ai/api/email/accounts/{id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true
}
CLI: 
puffle email account delete --id <id>

​
Overview

Disables warmup, deletes the warmup registration, deletes the backing inbox, and removes the DB row for a single inbox. External cleanup steps are best-effort; failures are logged but do not block the DB delete.
This operation shares the URL path /api/email/accounts/{id} with the update verb. See Update inbox to modify the signature without tearing the account down.

​
AI agent notes

Deletion is irreversible. The backing inbox service may block creating a new inbox with the same <username>@<domain> after deletion. If an agent is deleting an inbox on behalf of a user, confirm with the human first — the only recovery path is picking a different local part.External cleanup is best-effort. Warmup disable/delete and backing inbox delete are best-effort; failures are logged but do not block the DB delete. The only way this endpoint returns 500 is if the final DB delete itself fails.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Email account (accounts.id) UUID.

Minimum string length: 1

Response

Account deleted. External resources cleaned up best-effort; DB row guaranteed removed.

​
success
enum<boolean>
required
Available options:
true