Spam and held malware
Read messages in Spam, mark them Not spam, and understand why malware stays held.
Samva puts email flagged by receipt checks or the inbound classifier in Spam. You can read the message and see why it was flagged. Remote images stay blocked. Inbound email needs a passing malware scan to download attachments or the original email file, copy attachments into drafts, or forward an email with attachments. This applies to both mailbox and organization API downloads wherever the message appears. Attachment filenames, types, and sizes are still available.
Only confirmed malware stays held outside threads. Samva keeps the sender, subject, and receipt details. The body, attachments, and original email file are never stored.
Reasons
| Reason | What Samva detected |
|---|---|
spam | The receipt check or classifier identified likely spam. |
dmarc | The sender failed DMARC under a quarantine or reject policy. |
virus_unscanned | The malware scanner could not complete. |
verdict_missing | The receipt omitted a scan result. |
phishing | The classifier identified likely phishing. |
fraud | The classifier identified likely fraud. |
prompt_injection | The classifier identified an attempt to steer an AI agent. |
virus | The malware scan failed. The message stays held. |
Read and organize Spam
Pass folder=spam to List threads. A Spam thread's
spam field gives its reason and source. A reader can report spam by setting folder to spam
with Update thread. Set it to inbox for Not spam.
This sends a mailbox.message.received event for newly admitted mail. Downloads still require
a passing malware scan.
Hosted agents still require a passing malware scan and an authenticated sender.
Delete a Spam thread permanently using Delete thread. Empty Spam queues deletion of the threads currently in the folder. Samva also clears Spam threads after 30 days in Spam.
samva mailboxes threads "$MAILBOX_ID" --folder spam
samva mailboxes thread-update "$MAILBOX_ID" "$THREAD_ID" --data '{"folder":"inbox"}'
samva mailboxes spam empty "$MAILBOX_ID" --yesSpam in Samva Mail
Spam sits in Mail's sidebar beside Trash, with its unread count. An open Spam thread shows a banner
naming why it was flagged, with Not spam beside it. Press ! to report a conversation as spam,
or, in Spam, to mark it Not spam; G then P opens Spam. Delete forever and Empty Spam ask
before they delete. Held malware lists at the top of Spam with its sender and date; it cannot be
opened, and a member with spam.discard can delete it.
Review held malware
Use List held malware or the
mailbox_spam_held_list MCP tool with spam.read. A signed-in reader with spam.discard can
discard a held item. For the held list, limit defaults to 20 and is at most 100.
samva mailboxes spam list "$MAILBOX_ID"
samva mailboxes spam discard "$MAILBOX_ID" "$MESSAGE_ID" --yesEvents
mailbox.message.spam announces the screening reason and sender metadata. It carries a thread ID
for Spam and a null thread ID for held malware. Subscribe explicitly to receive it by webhook.
Hosted agents get the regular arrival event for newly admitted mail when a reader moves its thread
to Inbox. See Mailbox events.