---
title: "Delete mailFolder"
method: DELETE
path: "/me/mailFolders/{mailFolderId}"
tags: ["me.mailFolder"]
---

# Delete mailFolder

`DELETE /me/mailFolders/{mailFolderId}`

Delete the specified mailFolder. The folder can be a mailSearchFolder. You can specify a mail folder by its folder ID, or by its well-known folder name, if one exists.

## Headers

- `If-Match` string

## Response `204`

If successful, the mail folder is deleted and no content is returned. Unless, the folder may not exist or the caller may lack the required permission.

## Other responses

- `4XX` — error
- `5XX` — error

## Changes

- **2026-05-27** `354d90657cdd` — 1 info
  - api operation id `me.DeleteMailFolders` removed and replaced with `deleteMailFolder`
- **2026-05-26** `c6fc1d98f528` — 1 info
  - api operation id `deleteMailFolder` removed and replaced with `me.DeleteMailFolders`

[Change history](https://skmtc.dev/ballerina-platform/apis/microsoft-graph-mail-api/changes/me/mailFolders/:mailFolderId/delete.md)

---

[API](https://skmtc.dev/ballerina-platform/apis/microsoft-graph-mail-api.md) · [All operations](https://skmtc.dev/ballerina-platform/apis/microsoft-graph-mail-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ballerina-platform/microsoft-graph-mail-api/revisions/af62694b9f2d/schema)