API reference / Inboxes

Delete an inbox

Permanently retire an inbox and delete its mail. The address cannot be reused.

DELETE/v1/inboxes/{inboxId}

Requires an API key with the inboxes:write scope. MCP tool: delete_inbox. CLI: goshenemail inboxes delete.

Request

Name	Type	Required	Notes
`inboxId`	`string (email)`	Yes	up to 254 characters

Field	Type	Notes
`deleted`	`boolean`

Errors return { "error": { "code", "message", "transient" } } with a 4xx or 5xx status. See Errors.

curl "https://api.goshenemail.com/v1/inboxes/research%40agents.goshenemail.com" \
  -H "Authorization: Bearer $GOSHENEMAIL_API_KEY" \
  -X DELETE

goshenemail inboxes delete --inbox-id "research@agents.goshenemail.com"