Skip to Content

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

ReasonWhat Samva detected
spamThe receipt check or classifier identified likely spam.
dmarcThe sender failed DMARC under a quarantine or reject policy.
virus_unscannedThe malware scanner could not complete.
verdict_missingThe receipt omitted a scan result.
phishingThe classifier identified likely phishing.
fraudThe classifier identified likely fraud.
prompt_injectionThe classifier identified an attempt to steer an AI agent.
virusThe 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" --yes

Spam 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" --yes

Events

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.

Related documentation

On this page