DELETE
emails/{email_id}/
User APIService tier
Delete one logged email: its bodies, attachments, mailbox copies and timeline entry, and the mailbox sync will not import it again.
Allowed for the person whose mailbox it was synced from (or who logged it) and for workspace admins. Another person's private email answers 404, as does another organization's.
URL
- User APIhttps://sales.mattering.io/api/user/v1/emails/{email_id}/
- Service tierhttps://sales.mattering.io/api/internal/emails/{email_id}/
Path parameters
| Name | Type |
|---|---|
email_id | uuid |
Responses
200 data and meta envelope
{
"data": {
"id": "...",
"deleted": true
}
}
Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).
Errors
| Status | Code |
|---|---|
| 403 | forbidden |
| 403 | unknown_actor |
| 404 | not_found |
Example
curl -X DELETE "https://sales.mattering.io/api/user/v1/emails/EMAIL_ID/" \ -H "Authorization: Bearer $MATTERING_API_KEY"
curl -X DELETE "https://sales.mattering.io/api/internal/emails/EMAIL_ID/" \ -H "X-Internal-Secret: $MATTERING_INTERNAL_API_SECRET" \ -H "X-Internal-Org-Id: $ORG_ID" \ -H "X-Internal-User-Email: you@example.com"
Source: CRMCore/timeline_api.py (timeline_api.email_detail)