# Delete a folder

`DELETE https://app.clik.so/api/folders/{id}`

> **In short:** Deletes a folder. Its links are not deleted; they just leave the folder.

## You need

* **API key permission:** `write`
* **Workspace role:** editor or higher
* **Plan:** any plan, including Free

## Example

```bash
curl -X DELETE "https://app.clik.so/api/folders/6b7c8d9e-0f1a-4b2c-8d3e-4f5a6b7c8d9e" \
  -H "Authorization: Bearer $CLIKSO_API_KEY"
```

Response 204 No Content — an empty body means it worked.

## Parameters

| Name | In   | Type   | Required | Description      |
| ---- | ---- | ------ | -------- | ---------------- |
| `id` | path | string | yes      | The folder's id. |

## Common errors

| Status | Code           | When                                                                            |
| ------ | -------------- | ------------------------------------------------------------------------------- |
| 401    | `UNAUTHORIZED` | The API key is missing, malformed or unknown.                                   |
| 403    | `FORBIDDEN`    | The key only has Read permission, or its creator is a viewer in this workspace. |
| 404    | `NOT_FOUND`    | No folder with this id exists in the key's workspace.                           |
| 429    | `RATE_LIMITED` | The key went over its per-minute request limit.                                 |

## Good to know

* The links that were in the folder keep working. Their `folder_id` becomes `null`.
* The `204` response has no body.

---

Source: https://clik.so/docs/api/folders/delete-folder