---
title: "Delete app folder"
method: DELETE
path: "/api/app-folders/{item_id}"
---

# Delete app folder

`DELETE /api/app-folders/{item_id}`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/app-folders/{item_id}`
- Auth: HTTP bearer

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Deletes a folder. The apps in it stay in the workspace and are only taken out of the folder.

Set `mode` to decide what happens to the folders inside it: `reparent`, the default, moves them up into the deleted folder's parent, and `cascade` deletes them along with it, taking their apps out of folders too.

You can change your own personal folders. Workspace folders need the editor role or higher, and any editor can change any workspace folder. A folder that doesn't exist, or another user's personal folder, returns a `404` with the code `folder_not_found`.

This is limited to 60 requests per minute, shared with the other endpoints that change folders. A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit.

<Note>Call this with a personal access token sent as a Bearer token, or from a signed-in session. A token works on its own workspace's folders. Workspace API keys aren't accepted, and a read-only token is refused.</Note>

## Path parameters

- `item_id` string, required: ID of the folder to delete. Get it from `id` in [List app folders](/api-reference/list-app-folders).

## Query parameters

- `mode` 'reparent' | 'cascade': What happens to the folders inside it. `reparent`, the default, moves them up into the deleted folder's parent. `cascade` deletes them too.

## Response `200`

The folder was deleted.

- DeleteAppFolderResult
  - `deleted` boolean, required: Always `true`.
  - `mode` 'reparent' | 'cascade', required: The `mode` the folder was deleted with.

## Other responses

- `400`: `mode` isn't `reparent` or `cascade`.
- `401`: Missing or invalid credentials.
- `403`: The folder is a workspace folder and you're a viewer or guest, or your token is read-only.
- `404`: `folder_not_found`: the folder doesn't exist in the workspace, or it's another user's personal folder.
- `422`: Validation Error
- `429`: Rate limit exceeded.

## Changes

- **2026-10-11** `80287813ab84`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API
- **2026-10-07** `16e7d910d549`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/base44/apis/base44-app-management-api/changes/api/app-folders/:item_id/delete.md)

---

[API](https://skmtc.dev/base44/apis/base44-app-management-api.md) - [All operations](https://skmtc.dev/base44/apis/base44-app-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/base44/apis/base44-app-management-api/revisions/c534f09cf314?raw)