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

# Delete child folder

`DELETE /me/mailFolders/{mailFolderId}/childFolders/{mailFolderId1}`

## Request

- Base URL: `https://graph.microsoft.com/v1.0`
- URL: `https://graph.microsoft.com/v1.0/me/mailFolders/{mailFolderId}/childFolders/{mailFolderId1}`
- Auth: OAuth 2
  - Authorization code: `https://login.microsoftonline.com/common/oauth2/v2.0/authorize`
  - Client credentials
  - Token URL: `https://login.microsoftonline.com/common/oauth2/v2.0/token` scopes: `Mail.Read`, `Mail.ReadWrite`, `Mail.Send`
- TypeScript: <https://skmtc.dev/ballerina-platform/apis/microsoft-graph-mail-api/docs/me/mailFolders/:mailFolderId/childFolders/:mailFolderId1/delete.ts> (a function with typed inputs; its response is checked against the schema)

## Headers

- `If-Match` string

## Response `204`

If successful, the child 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-28** `354d90657cdd`: 1 info
  - api operation id `me.mailFolders.DeleteChildFolders` removed and replaced with `deleteChildFolder`
- **2026-05-28** `c6fc1d98f528`: 1 info
  - api operation id `deleteChildFolder` removed and replaced with `me.mailFolders.DeleteChildFolders`

[Operation history](https://skmtc.dev/ballerina-platform/apis/microsoft-graph-mail-api/changes/me/mailFolders/:mailFolderId/childFolders/:mailFolderId1/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.dev/ballerina-platform/apis/microsoft-graph-mail-api/revisions/af62694b9f2d?raw)