request_inbound_action

bot.mailbox/mailbox · Verify this server

Propose a scan, forward or discard through POST /v1/inbound-items/:id/actions. Agent keys only; the proposal always waits for the owner's approval (awaiting_member_approval: true) and never charges credits or moves mail by itself. Send the item's current version as action.expected_version, a stable idempotency_key for retries, and for forward a complete US destination (first_class requires untracked_acknowledged: true). Forward destinations and discard proposals are checked against the agent's inbound_policy server-side. One open action per item. Required scope: inbound.act (legacy aliases accepted). Member keys read their own live items; agent keys read items bound or assigned to them, in their key's environment. Proposals are agent-only and always wait for the owner: they never charge credits, buy postage, open, forward or discard anything by themselves. Forward destinations and discard proposals are checked against the agent's structured inbound policy. Image URLs are never issued to agents. Stop on denial; never switch keys or mail APIs to bypass it.