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.
Summary
Agent Drive is now in AgentMail Labs. Every inbox has a drive where your agent can upload files by path, list them, hand out signed download links, and let files expire.
What’s new?
- Upload:
POST /v0/inboxes/{inbox_id}/filesreturns an upload URL;PUTthe bytes to it, thenPOST /v0/inboxes/{inbox_id}/files/{file_id}/complete. Files can be up to 100 MiB, and storage checks each upload’s size and SHA-256. - Download:
GET /v0/inboxes/{inbox_id}/files/{file_id}returns a signeddownload_urlthat works for up to an hour, with no API key. - List and delete: list an inbox’s files in path order, optionally by
path_prefix, and delete them. - Expiry: pass
expires_atand a file deletes itself. - Quota: 1 GiB and 10,000 files per organization by default.
- Permissions:
file_read,file_create,file_update(reserved) andfile_delete. - Availability: US production (
api.agentmail.to), not yet EU production (api.agentmail.eu).
Use cases
- Keep the reports, exports and attachments your agent produces where it and the people it works with can get them.
- Share a file by link instead of attaching it to every email.
Read Agent Drive to get started.
