> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.
# Delete app folder
> This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
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.
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.
## OpenAPI
````yaml /developers/references/app-management/app-management-openapi.json delete /api/app-folders/{item_id}
openapi: 3.1.0
info:
title: Base44 App Management API
version: 1.0.0
servers:
- url: https://app.base44.com
security:
- PersonalAccessTokenAuth: []
paths:
/api/app-folders/{item_id}:
delete:
summary: Delete app folder
description: >-
This API is in beta. Endpoints, fields, and behavior may still
change, so avoid depending on it in production.
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.
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.
operationId: api_delete_api_app_folders__item_id__delete
parameters:
- name: item_id
in: path
required: true
schema:
type: string
description: >-
ID of the folder to delete. Get it from `id` in [List app
folders](/api-reference/list-app-folders).
title: Item Id
description: >-
ID of the folder to delete. Get it from `id` in [List app
folders](/api-reference/list-app-folders).
example: 68c1f2a9b4e7d3005a2c9e11
- name: mode
in: query
required: false
schema:
type: string
description: >-
What happens to the folders inside it. `reparent`, the default,
moves them up into the deleted folder's parent. `cascade` deletes
them too.
enum:
- reparent
- cascade
default: reparent
title: Mode
description: >-
What happens to the folders inside it. `reparent`, the default,
moves them up into the deleted folder's parent. `cascade` deletes
them too.
example: reparent
responses:
'200':
description: The folder was deleted.
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteAppFolderResult'
'400':
description: '`mode` isn''t `reparent` or `cascade`.'
'401':
description: Missing or invalid credentials.
'403':
description: >-
The folder is a workspace folder and you're a viewer or guest, or
your token is read-only.
'404':
description: >-
`folder_not_found`: the folder doesn't exist in the workspace, or
it's another user's personal folder.
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
'429':
description: Rate limit exceeded.
components:
schemas:
DeleteAppFolderResult:
properties:
deleted:
type: boolean
title: Deleted
description: Always `true`.
example: true
mode:
type: string
enum:
- reparent
- cascade
title: Mode
description: The `mode` the folder was deleted with.
example: reparent
type: object
required:
- deleted
- mode
title: DeleteAppFolderResult
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
securitySchemes:
PersonalAccessTokenAuth:
type: http
scheme: bearer
description: 'Personal access token, sent as `Authorization: Bearer `.'
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.