Mail

Delete a folder

Deletes the folder and every message in it (and its subfolders). The system folders cannot be deleted (403). Requires scope mail:write.

delete/mailboxes/{address}/folders/{path}

Request

  • Base URL: https://faivelo.com/api/v1
  • URL: https://faivelo.com/api/v1/mailboxes/{address}/folders/{path}
  • Auth: HTTP bearer

Path parameters

addressstring required

Full mailbox address, e.g. user@yourdomain.com

pathstring required

The folder's path from the list endpoint. A nested folder keeps its slashes: Projects/2026.

Response

Folder deleted

successboolean

Example response

{
  "success": true,
  "data": {
    "deleted": true
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.