---
title: "Delete folder"
method: DELETE
path: "/v1/folders/{id}"
tags: ["Folders"]
---

# Delete folder

`DELETE /v1/folders/{id}`

## Request

- Base URL: `https://api.forwardemail.net`
- URL: `https://api.forwardemail.net/v1/folders/{id}`
- Auth: HTTP basic

Delete a specific folder. Its messages are moved to Trash (messages in Trash or Junk are deleted permanently), and folders inside it are kept. INBOX cannot be deleted. You can use either the folder's ObjectID or its path as the identifier.

## Path parameters

- `id` string, required

## Response `200`

Folder deleted successfully

- Folder
  - `id` string, required: Folder ID
  - `path` string, required: Full folder path
  - `name` string, required: Folder name (last part of path)
  - `parent` string, nullable, required: Parent folder path
  - `uid_validity` integer, required: IMAP UID validity
  - `uid_next` integer, required: Next UID value
  - `modify_index` integer, required: Modification index
  - `subscribed` boolean, required: Whether folder is subscribed
  - `flags` string[], required: Folder flags
  - `retention` integer, nullable, required: Message retention period
  - `special_use` string, nullable, required: Special use designation
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `object` 'folder', required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/forwardemail/apis/forward-email-api.md) · [All operations](https://skmtc.dev/forwardemail/apis/forward-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forwardemail/apis/forward-email-api/revisions/ecefab4527f6?raw)