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

{
  "deleted": true,
  "mode": "reparent"
}