---
title: "Delete Folder"
method: DELETE
path: "/v2/workspaces/{workspace_id}/folders/{folder_id}"
tags: ["v2 - Workspaces", "Folders"]
---

# Delete Folder

`DELETE /v2/workspaces/{workspace_id}/folders/{folder_id}`

## Request

- Base URL: `https://api.jubjubapp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.jubjubapp.com/v2/workspaces/{workspace_id}/folders/{folder_id}`
- Auth: HTTP bearer

Remove the folder and move everything in it up one level. Deletes no
piece, no media and no file: each piece in it gets folder_id = the
folder's parent (one field), each child folder gets the folder's parent,
and only then is the folder record removed. Access: CONTENT_ORGANISE.

## Path parameters

- `workspace_id` string, required
- `folder_id` string, required

## Headers

- `Authorization` string
- `X-JubJub-Service-Key` string
- `X-JubJub-Agent-Key` string
- `X-JubJub-Platform-Key` string
- `Origin` string
- `Referer` string
- `X-JubJub-Trial-Token` string

## Response `200`

Successful Response

- DeleteFolderResponse
  - `deleted` string, required
  - `moved_to` string, nullable
  - `pieces_moved` integer, required
  - `folders_moved` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/jubjubapp/apis/jubjub-api.md) - [All operations](https://skmtc.dev/jubjubapp/apis/jubjub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jubjubapp/apis/jubjub-api/revisions/353157b296f2?raw)