Developers
Open Swarmhit
Smart APIRaw API
API referenceEmail accounts
PATCH
/email/api/v1/accounts/{id}

The proxy its IMAP and SMTP connections go through (a public host only); null clears it.

Authorization

X-API-KEY<token>

Your API key from the console (gw_live_…).

In: header

Path Parameters

id*string

A mailbox (em_…).

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/email/api/v1/accounts/em_gX2kP9qL4mT7vB1nR8sW3yZ" \  -H "Content-Type: application/json" \  -d '{    "proxy": {      "host": "string",      "port": 0    }  }'
{  "object": "AccountPatched",  "account_id": "string"}

List mailboxes GET

Newest first, with totals per status. Deleted mailboxes are not listed.

Reconnect a mailbox POST

New credentials or settings for the same mailbox, in place (same id), with the same body as a connect. `provider` may differ from the mailbox's type (a password mailbox moved to your Google or Microsoft OAuth app, or back): the old login is replaced and the account's `type` follows. The next `OK` is sent as `RECONNECTED`; a refused reconnect changes nothing.