Summary
Remove a sub-account. When it still has inboxes, the call returns 409 workspace_not_empty unless delete_inboxes=true. That flag deletes direct inboxes, their messages, attachments, owners, and tasks, then the workspace API keys, OAuth tokens, webhooks, domains, and the child account. An approval inbox returns 409 owner_required and deletes nothing until its owner confirms. The response is {id, deleted:true, inboxes_deleted}. The child key then returns 401. Parent plan usage no longer counts that sub-account. Another parent's workspace returns 404 workspace_not_found. A sub-account key returns 403 permission_denied. Held message bodies stay withheld until release, and a suppressed address still cannot be mailed. MCP: cooper_delete_workspace.
Request
This call has no JSON body.
Response
HTTP 200. Sample values illustrate the schema.
{
"id": "inb_example",
"deleted": true,
"inboxes_deleted": 1
}Errors
- HTTP 409 workspace_not_empty
- HTTP 409 owner_required
- HTTP 404 workspace_not_found
- HTTP 403 permission_denied
Idempotency
This route does not document Idempotency-Key or client_id.