Summary
Agent Armor can now hold mail. In Hold mode, your agents hear about a message only once its scan finishes, and a message marked review stays held from them until someone releases it.
What’s new?
- Hold mode: an organization admin switches Agent Armor between Monitor, the default, and Hold in the console under Settings, then Labs. Hold sends no
message.security.completed: the result arrives onmessage.received, or onmessage.security.reviewfor a held message. agent-armor-heldlabel: a held message carries it until it is released, and its thread while any of its messages is held. List them by it, withinclude_spam,include_blockedandinclude_unauthenticated, to see held mail.message.security.review: a webhook and WebSocket event sent when a message is held.- Release:
POST /v0/inboxes/{inbox_id}/messages/{message_id}/agent-armor/releasereleases a held message with a reason. Itsmessage.receivedthen goes to your agents, andmessage.security.overrideis sent too, in either order. Admins can also release from the console. agent_armor_releasepermission: opt-in, so an agent’s own key can’t release mail held from it. See Permissions.manual_override: a released message’sagent_armorresult records how, when and why it was released.
Use cases
- Keep mail that may manipulate an agent away from it until a person has checked it.
- Give a review tool, not your agents, the key that releases held mail.
Read Hold mode to get started.
