Skip to navigation
API ReferenceInboxesForwarding

Delete Forwarding

Remove this inbox’s own forwarding, so the inbox uses its pod’s or the organization’s forwarding again. Verified addresses stay verified. Returns not_found when the inbox sets no forwarding.

CLI:

agentmail inboxes forwarding delete --inbox-id <inbox_id>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

inbox_idstringRequired
The ID of the inbox.

Response

This endpoint returns an object.
destinationslist of strings or null

Addresses this level forwards to. null when the level sets nothing and uses the forwarding of the level above. An empty list means forwarding is turned off at this level, even when a level above forwards.

unverifiedlist of strings

Addresses in destinations that receive nothing yet because they are not verified, or because the address now reaches a different AgentMail inbox than the one it was verified for. Verify them with Start Verification and Confirm Verification. Empty when destinations is null.

Errors

403
Forwarding Forbidden Error
404
Not Found Error