Email flagged as spam, phishing, fraud, or an attempt to steer an agent goes to Spam. You can read it and see why it was flagged. Confirmed malware stays held without its contents.
Move a thread to Inbox to mark it Not spam. Newly admitted messages then reach agents and received-event subscribers. Spam threads can be permanently deleted and are cleared after 30 days.
The mailbox API now lists Spam with folder=spam. Use mailbox.message.spam for screening
metadata and mailbox.message.received for newly admitted mail. The permissions for held malware
are spam.read and spam.discard.