Clickup

clickup Folders API

Operations for managing Folders within ClickUp Spaces.

GitHub OpenAPI

Operations 12

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v2/space/{space_id}/folder List the Folders in a Space (v2) · Get Folders #
Ask an LLM
“What Folders and subfolders are in a ClickUp Space?”
“How can I tell which Folder a subfolder is nested inside when listing a Space's Folders via v2?”
Tell an agent
List the Folders and subfolders in Space {space_id} via v2.
Show Space {space_id}'s Folders with archived set to {archived}.
POST /v2/space/{space_id}/folder Create a Folder or subfolder (v2) · Create Folder #
Ask an LLM
“Can I create a subfolder inside an existing Folder with the v2 API?”
“What do I need to add a new Folder to a Space through v2?”
Tell an agent
Using v2, create Folder {name} in Space {space_id}.
Create subfolder {name} under Folder {parent_folder_id} in Space {space_id}.
GET /v2/folder/{folder_id} Retrieve a Folder and its Lists (v2) · Get Folder #
Ask an LLM
“Can I see a Folder's Lists together with its nested subfolders via v2?”
“How do I tell if a Folder is itself a subfolder?”
Tell an agent
Get v2 Folder {folder_id} with its Lists.
Show Folder {folder_id} including subfolders: {include_subfolders}.
PUT /v2/folder/{folder_id} Rename a Folder (v2) · Update Folder #
Ask an LLM
“Does renaming a subfolder in v2 keep it nested under its parent?”
“Can the v2 rename call also move a Folder somewhere else?”
Tell an agent
Using v2, rename Folder {folder_id} to {name}.
Give v2 subfolder {folder_id} the new title {name} without moving it.
DELETE /v2/folder/{folder_id} Delete a Folder (v2) · Delete Folder #
Ask an LLM
“How do I delete a Folder from my Workspace with v2?”
“Is there a v2 call to get rid of an empty Folder?”
Tell an agent destructive · confirm first
Delete v2 Folder {folder_id}.
Remove Folder {folder_id} from my Workspace through v2.
PUT /v2/folder/{folder_id}/position Move or nest a Folder · Move Folder #
Ask an LLM
“Can I nest one Folder inside another as a subfolder?”
“What happens to custom task types when I move a Folder to a different Space?”
Tell an agent
Nest Folder {folder_id} inside Folder {parent_folder_id}.
Move Folder {folder_id} to Space {space_id} as a top-level Folder at position {position}.
POST /v2/space/{space_id}/folder_template/{template_id} Create a Folder from a template · Create Folder from template #
Ask an LLM
“Can I build a whole Folder with its Lists and tasks from a saved template?”
“Is it possible to place a templated Folder under a parent Folder?”
Tell an agent
Create Folder {name} in Space {space_id} from template {template_id}.
Apply Folder template {template_id} in Space {space_id} as {name} under parent {parent_folder_id}.
GET /space/{space_id}/folder List a Space's Folders (legacy path) · Get folders #
Ask an LLM
“On the older unversioned path, how do I fetch every Folder in a Space?”
“Can the legacy endpoint return archived Folders?”
Tell an agent
On the legacy path, fetch all Folders in Space {space_id}.
Using the older endpoint, pull Space {space_id}'s Folders, archived: {archived}.
POST /space/{space_id}/folder Create a Folder (legacy path) · Create a folder #
Ask an LLM
“Does the older unversioned API make new Folders in a Space?”
“On the legacy path, is a name all a new Folder needs?”
Tell an agent
On the legacy path, make Folder {name} in Space {space_id}.
Using the older endpoint, set up a Folder titled {name} under {space_id}.
GET /folder/{folder_id} Retrieve a Folder (legacy path) · Get a folder #
Ask an LLM
“On the older unversioned path, how do I read a Folder's configuration?”
“Does the legacy Folder lookup include its Lists?”
Tell an agent
On the legacy path, read Folder {folder_id} and its Lists.
Using the older endpoint, describe Folder {folder_id}.
PUT /folder/{folder_id} Update a Folder (legacy path) · Update a folder #
Ask an LLM
“Can the older unversioned endpoint edit a Folder's properties?”
“On the legacy path, how is a Folder retitled?”
Tell an agent
On the legacy path, retitle Folder {folder_id} as {name}.
Using the older endpoint, edit the properties of Folder {folder_id}.
DELETE /folder/{folder_id} Delete a Folder and contents (legacy path) · Delete a folder #
Ask an LLM
“Does erasing a Folder on the older unversioned path also destroy its Lists and tasks?”
“Can a Folder wiped through the legacy endpoint be recovered?”
Tell an agent destructive · confirm first
Permanently erase Folder {folder_id} with all its Lists and tasks on the legacy path.
Using the older endpoint, wipe out Folder {folder_id}.

Documentation

📖
Documentation
https://developer.clickup.com/docs/tasks
📖
Documentation
https://developer.clickup.com/reference/get-spaces
📖
Documentation
https://developer.clickup.com/reference/get-lists
📖
Documentation
https://developer.clickup.com/reference/get-folders
📖
Documentation
https://developer.clickup.com/reference/get-goals
📖
Documentation
https://developer.clickup.com/reference/get-task-comments
📖
Documentation
https://developer.clickup.com/reference/get-teams
📖
Documentation
https://developer.clickup.com/docs/webhooks
📖
Documentation
https://developer.clickup.com/reference/get-accessible-custom-fields
📖
Documentation
https://developer.clickup.com/reference/get-time-entries-within-a-date-range
📖
Documentation
https://developer.clickup.com/reference/get-views
📖
Documentation
https://developer.clickup.com/docs/authentication

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/openapi/clickup-folders-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/asyncapi/clickup-webhooks-asyncapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/clickup-folders-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

clickup-folders-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Clickup Folders API
  version: '2.0'
  description: 'Operations tagged Folders across 2 of this provider''s published API definitions: clickup-api-v2-reference-openapi.json, clickup-folders-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.clickup.com/api
  description: ClickUp
  variables: {}
- url: https://api.clickup.com/api/v2
  description: ClickUp API v2 Production Server
tags:


# --- truncated at 32 KB (54 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/openapi/clickup-folders-api-openapi.yml