---
title: "Remove app from folder"
method: DELETE
path: "/api/app-folders/{folder_id}/items/{app_id}"
---

# Remove app from folder

`DELETE /api/app-folders/{folder_id}/items/{app_id}`

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

Takes an app out of a folder. The app stays in the workspace. Removing an app that isn't in the folder succeeds and changes nothing.

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`. A personal access token limited to selected apps can only use the apps it lists. Any other app ID returns a `404`.

This is limited to 600 requests per minute. 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

- `folder_id` string, required — ID of the folder to remove the app from. Get it from `id` in [List app folders](/api-reference/list-app-folders).
- `app_id` string, required — ID of the app to take out of the folder.

## Response `200`

The app isn't in the folder anymore.

- RemoveFolderAppResult
  - `unlinked` boolean, required — Always `true`, including when the app wasn't in the folder.
  - `folder_id` string, required — ID of the folder.
  - `app_id` string, required — ID of the app, in lowercase.

## Other responses

- `400` — `app_id` isn't a valid app ID.
- `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. Also returned when your personal access token is limited to selected apps and doesn't list the app.
- `429` — Rate limit exceeded.

## Changes

- **2026-10-07** `16e7d910d549` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/idealspot/apis/base44-app-management-api/changes/api/app-folders/:folder_id/items/:app_id/delete.md)

---

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