Skip to navigation

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 on message.received, or on message.security.review for a held message.
  • agent-armor-held label: a held message carries it until it is released, and its thread while any of its messages is held. List them by it, with include_spam, include_blocked and include_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/release releases a held message with a reason. Its message.received then goes to your agents, and message.security.override is sent too, in either order. Admins can also release from the console.
  • agent_armor_release permission: opt-in, so an agent’s own key can’t release mail held from it. See Permissions.
  • manual_override: a released message’s agent_armor result 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}/files returns an upload URL; PUT the bytes to it, then POST /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 signed download_url that 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_at and a file deletes itself.
  • Quota: 1 GiB and 10,000 files per organization by default.
  • Permissions: file_read, file_create, file_update (reserved) and file_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.