> ## 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.

# Delete app folder

> <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, and each workspace API key has its own. Some workspaces have a different limit.

<Note>Call this with a personal access token sent as a Bearer token, a workspace API key, or from a signed-in session. A token or key works on its own workspace's folders, and a workspace API key acts as the workspace owner. Read-only tokens and keys are refused.</Note>



## 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: >-
        <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, and each
        workspace API key has its own. Some workspaces have a different limit.


        <Note>Call this with a personal access token sent as a Bearer token, a
        workspace API key, or from a signed-in session. A token or key works on
        its own workspace's folders, and a workspace API key acts as the
        workspace owner. Read-only tokens and keys are refused.</Note>
      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.
        '503':
          description: >-
            Database temporarily unavailable (`database_unavailable`): the data
            cluster did not answer in time. Retry after the `Retry-After`
            seconds.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorEnvelope'
              examples:
                database_unavailable:
                  summary: database_unavailable
                  value:
                    error:
                      code: database_unavailable
                      message: Database temporarily unavailable, please retry
                      details: {}
      security:
        - PersonalAccessTokenAuth:
            - full_access
        - WorkspaceApiKeyAuth:
            - full_access
        - WorkspaceApiKeyBearerAuth:
            - full_access
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
    StandardErrorEnvelope:
      properties:
        error:
          $ref: '#/components/schemas/StandardError'
          description: What went wrong.
      type: object
      required:
        - error
      title: StandardErrorEnvelope
      description: The error body returned in the standard envelope.
    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
    StandardError:
      properties:
        code:
          type: string
          title: Code
          description: >-
            Stable machine-readable cause of the failure. Match on this, not on
            `message`.
          example: not_found
        message:
          type: string
          title: Message
          description: Human-readable explanation. It isn't a stable contract.
          example: App not found
        details:
          additionalProperties: true
          type: object
          title: Details
          description: >-
            Structured context for the failure, or an empty object when there's
            none.
          example: {}
      type: object
      required:
        - code
        - message
      title: StandardError
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: >-
        Personal access token, sent as `Authorization: Bearer <token>`. Each
        operation lists the permission it needs: `read_only` or `full_access`. A
        full-access token can call every operation. A read-only token can call
        only the operations that list `read_only`; anything else returns 403
        `read_only_credential_route_not_allowed`.
    WorkspaceApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: >-
        Workspace API key, sent as `api_key: <key>`. Each operation that accepts
        one lists what the key needs: a permission, `read_only` or
        `full_access`, like a personal access token, or a scope. A key without
        the scope gets 403 `workspace_api_key_scope_required`.
    WorkspaceApiKeyBearerAuth:
      type: http
      scheme: bearer
      description: >-
        Workspace API key, sent as `Authorization: Bearer <key>`. Accepted
        wherever `api_key` is, with the same permission.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.