Resolido Docs
Channels

Issue a new forwarding address

POST
/mailboxes/{mailboxId}/forwarding/rotate

Issue a new forwarding address (the old one stops working; forwarding must be set up again). Owner/admin.

Authorization

bearer channels:write
headerAuthorizationBearer <token>

API key (rsl_live_…) from Settings → Developers.

Scope: channels:write

Path Parameters

mailboxId*string

Mailbox id. Never invent ids – list resources first.

Length1 <= length <= 64

Request Body

application/json
  1. body
confirmationToken?string

Destructive operations run in two steps: call without this field, show the returned summary to the user, and only after their explicit approval call again with the returned confirmation_token.

Lengthlength <= 512

Response Body

Success

application/json
  1. response
routeId*string
forwardingAddress*string

Private address the mailbox forwards to.

status*string
allowlistDomains*array<string>
allowlistEmails*array<string>
lastInboundAt*number

Unix time in milliseconds (UTC).

curl -X POST "https://example.com/mailboxes/string/forwarding/rotate" \  -H "Content-Type: application/json" \  -d '{}'
{  "routeId": "string",  "forwardingAddress": "string",  "status": "string",  "allowlistDomains": [    "string"  ],  "allowlistEmails": [    "string"  ],  "lastInboundAt": 0}