How to Delete a Folder Using the ClickUp API

This guide explains how to delete a Folder in ClickUp using the official REST API. You will learn what the Delete Folder endpoint does, which parameters it requires, how to structure your request, and how to avoid common mistakes when removing Folders from your workspaces.

Understanding the ClickUp Delete Folder Endpoint

The Delete Folder operation is provided as a dedicated HTTP endpoint in the ClickUp API. It lets you permanently remove an existing Folder from a Space. When you call this endpoint successfully, the Folder and its nested structure are removed from your workspace.

The endpoint is:

DELETE https://api.clickup.com/api/v2/folder/{folder_id}

This action cannot be undone through the API, so it is important to confirm that you are targeting the correct Folder before sending the request.

Before You Delete a Folder in ClickUp

Before using the Delete Folder API endpoint, make sure you have the following:

• A valid ClickUp API token with permissions to modify the target Workspace and Space.
• The correct folder_id for the Folder you want to delete.
• Network access that allows HTTPS requests to the ClickUp API.

You should also confirm that deleting the Folder is the right choice, especially if the Folder contains important Lists or tasks.

Required Parameters for the ClickUp Folder Deletion

The Delete Folder endpoint is straightforward and uses a single required path parameter. There is no request body, and query parameters are not needed for a standard request.

Path Parameter: folder_id

The only required path parameter is:

• folder_id — The unique identifier of the Folder you want to delete.

In the URL, replace {folder_id} with the actual ID value. For example:

DELETE https://api.clickup.com/api/v2/folder/1234

You can obtain the folder_id from previous API calls (such as list Folders in a Space) or from other parts of your integration with ClickUp.

Authentication and Headers for ClickUp API Requests

To successfully call the Delete Folder endpoint, you must pass an authentication header. The ClickUp API uses a personal token or OAuth token for authorization.

Required Authorization Header

Include the following header in your request:

• Authorization: <your_token_here>

Replace <your_token_here> with your actual ClickUp API token. Without this header, the request will fail with an authentication error.

Optional Headers and Content Type

Because the Delete Folder request does not send a body, a Content-Type header is generally not required. However, some HTTP clients automatically add it. This does not affect the operation of the ClickUp endpoint as long as Authorization is correctly included.

Step-by-Step: Delete a Folder with the ClickUp API

Use the following process to remove a Folder safely and reliably.

1. Confirm the Folder in ClickUp

First, verify that the selected Folder is the one you intend to remove. You can:

• Check the Folder details via the ClickUp web interface.
• Call other API endpoints to list Folders and confirm the folder_id.

2. Prepare the HTTP Request

Set your HTTP method to DELETE and construct the full endpoint URL with the correct folder_id. For example:

DELETE https://api.clickup.com/api/v2/folder/1234

Add the Authorization header containing your ClickUp API token.

3. Send the Request to ClickUp

Use your preferred HTTP client or integration platform to send the request:

• cURL from the command line
• API testing tools such as Postman or Insomnia
• Custom code using an HTTP library in your chosen language

4. Check the Response Status

On success, the endpoint responds with a status code that indicates the Folder has been removed. Common outcomes include:

• Successful deletion: The Folder is no longer available via other ClickUp API calls.
• Error due to permissions: The token does not have rights to delete that Folder.
• Error due to invalid folder_id: The Folder does not exist or the identifier is malformed.

Always log or inspect the response status code and message so you can act on any issues that appear.

Error Handling for the ClickUp Delete Folder Endpoint

When the ClickUp API returns an error for a Delete Folder call, review both the HTTP status and the response body. Typical problems include:

• Missing or invalid Authorization header.
• Incorrect or unknown folder_id.
• Lack of permission to modify the Workspace or Space.

Update your token, verify the Folder’s existence, or adjust user permissions as needed before retrying the request.

Best Practices for Managing Folders in ClickUp via API

When automating Folder management, follow a few best practices to keep your workspace safe and organized.

• Log all delete operations: Record the folder_id, timestamp, and user or service that initiated the delete.
• Validate before deletion: Confirm the Folder’s contents or name via a read call before executing a Delete Folder request.
• Limit destructive access: Restrict who can run Folder deletion scripts that target the ClickUp API.

These steps reduce the risk of unintended data loss when working with your workspace programmatically.

ClickUp API Documentation and Further Help

If you need more detail about the Delete Folder endpoint, refer to the official documentation. The reference includes live examples and exact response formats for the ClickUp API. You can view the endpoint specification here: Delete Folder reference page.

For consulting, implementation strategy, or help optimizing your broader workflow setup and integrations, you can explore professional services at Consultevo.

Summary: Removing Folders with the ClickUp API

The Delete Folder endpoint provides a direct way to remove a Folder from your Space through the ClickUp API. By supplying the correct folder_id, including the required Authorization header, and carefully verifying your target Folder, you can automate Folder cleanup while maintaining control over your workspace structure.

Use this process in scripts, integrations, and automation systems whenever you need a reliable, repeatable method for deleting Folders in ClickUp.

Need Help With ClickUp?

If you want expert help building, automating, or scaling your ClickUp workspace, work with ConsultEvo — trusted ClickUp Solution Partners.

Get Help

“`