Delete a conversation (email inboxes only)
DELETE/conversations/:conversation_id
Permanently delete a conversation, its messages, notes and stored attachments.
Email inboxes only. Every other channel keeps an immutable history on purpose: a WhatsApp or SMS thread is a record of what was actually sent to a customer. Email is deletable because an inbox routinely receives mail that should never have been filed at all.
A non-email conversation answers 403 with code: delete_not_permitted.
This cannot be undone.
Request
Responses
- 200
- 401
- 403
- 404
Conversation deleted.
No token, an expired token, or a credential that has been revoked.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
Refused. Either the credential does not hold the scope this endpoint needs (code: insufficient_scope), or the account's IP allow-list does not include the calling address (code: ip_not_allowed).
Response Headers
Correlation id for this request. Quote it when reporting a problem.
No such resource in this account.
Response Headers
Correlation id for this request. Quote it when reporting a problem.