Mailboxes

Discard a quarantined message

Removes a held message from the mailbox's quarantine for good: it leaves the quarantine list, never reaches a thread, and can no longer be released. Quarantined and isolated (malware) messages can both be discarded. Publishes one mailbox.message.discarded event; discarding it again returns the same result and publishes nothing. A released message is in its thread and cannot be discarded: 409. Only a person can discard; API keys never hold quarantine.release.

post/v1/mailboxes/{id}/messages/{messageId}/discard

Request

  • Base URL: https://api.samva.dev
  • URL: https://api.samva.dev/v1/mailboxes/{id}/messages/{messageId}/discard
  • Auth: API key in header x-api-key

Path parameters

idstring required
messageIdstring required

Response

MailboxQuarantinedMessage

idstring required
disposition'quarantined' | 'isolated' required
reason'spam' | 'dmarc' | 'virus' | 'virus_unscanned' | 'phishing' | 'fraud' | 'prompt_injection' required
source'receipt' | 'classifier' required
subjectstring nullable required
receivedAtstring required
heldAtstring required
releasedAtstring nullable required
threadIdstring required
discardedAtstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.