Delete a message
Soft-deletes a message to trash or permanently purges it. Use label to detach from a single label.
bearerAuthAuthorizationBearer <token>Two credential kinds share this scheme; GET /api/v1/auth/whoami answers which one you hold and what it reaches.
oek_… API key (minted by POST /api/v1/api-keys; shown once at mint). role: account reaches the full account surface: the directory (domains, routes, patterns, api-keys, accounts, address lists) plus every mailbox the account owns. role: system additionally reaches the operator surface, which is documented separately.
oemp_… mailbox app password (minted by POST /api/v1/identities/{identityId}/credentials). Reaches ONE mailbox: its messages, labels, threads, search, sync, send, filters and PIM collections. Directory routes refuse it with 403 insufficient_scope.
Refusal vocabulary: a missing, malformed, expired, or revoked credential answers 401 unauthorized with a WWW-Authenticate: Bearer challenge; a VALID credential outside its scope answers 403 (insufficient_scope for an app password on a directory route, system_credentials_required where only the operator may call). The public routes (health, branding, token-in-path capabilities) declare security: [].
mailboxId*stringMailbox ULID identifier
messageId*stringMessage ULID identifier
label?stringRemove message from this specific label only
purge?stringSet to 'true' to permanently delete message immediately instead of moving to trash
"true""false"Message deletion result
application/json- response
blobOrphaned?booleanTrue if message blob was permanently deleted from storage
deleted?booleanTrue if message was deleted
expunged?booleanTrue if the message was expunged (Recently deleted tier)
expungedAt?integerTimestamp when the message was expunged, in epoch seconds
int64purgeAfter?integerTimestamp when message will be permanently purged
int64purged?booleanTrue if message was permanently purged
removedFromLabel?stringLabel name the message was removed from
curl -X DELETE 'https://api.open.email/api/v1/mailboxes/string/messages/string'{
"blobOrphaned": true,
"deleted": true,
"expunged": true,
"expungedAt": 0,
"purgeAfter": 0,
"purged": true,
"removedFromLabel": "string"
}Update message flags and labels PATCH
Updates message flags, adds or removes labels, and modifies custom keywords. Removing a message's LAST label expunges it to the Recently-deleted tier…
Get parsed message content and attachments GET
Returns decoded email headers, inline plain text and HTML bodies, and attachment metadata for a message.