Clickup

clickup Lists API

Operations for managing Lists within ClickUp Spaces and Folders.

GitHub OpenAPI

Operations 19

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/folder/{folder_id}/list List the Lists in a Folder (v2) · Get Lists #
Ask an LLM
“What Lists are inside a given ClickUp Folder?”
“Can I include archived Lists when I read a Folder's contents through v2?”
Tell an agent
Show the Lists in Folder {folder_id} via v2.
List Folder {folder_id}'s Lists with archived set to {archived}.
POST /v2/folder/{folder_id}/list Create a List in a Folder (v2) · Create List #
Ask an LLM
“Can I create a List in a Folder with a markdown description and due date using v2?”
“Is it possible to assign an owner and priority to a List as I create it inside a Folder?”
Tell an agent
Using v2, add a List named {name} to Folder {folder_id}.
Make a v2 List {name} in Folder {folder_id} due {due_date}, priority {priority}, owned by {assignee}.
GET /v2/space/{space_id}/list List Lists not in a Folder (v2) · Get Folderless Lists #
Ask an LLM
“Which Lists sit directly in a Space outside of any Folder?”
“Does v2 let me include archived folderless Lists?”
Tell an agent
Show Space {space_id}'s Lists that aren't in a Folder, via v2.
Include archived ones when listing folderless Lists in Space {space_id}: {archived}.
POST /v2/space/{space_id}/list Create a List directly in a Space (v2) · Create Folderless List #
Ask an LLM
“Can I add a List to a Space without putting it in a Folder, using v2?”
“What fields can I set when creating a folderless List in v2?”
Tell an agent
Using v2, create a folderless List {name} in Space {space_id}.
Add List {name} straight under Space {space_id} with status {status} and markdown description {markdown_content}.
GET /v2/list/{list_id} Retrieve a List's details (v2) · Get List #
Ask an LLM
“What information does ClickUp's v2 API return about a single List?”
“Can I look up one List by its ID?”
Tell an agent
Get the v2 details for List {list_id}.
Show me everything about List {list_id} from the v2 endpoint.
PUT /v2/list/{list_id} Edit a List's settings (v2) · Update List #
Ask an LLM
“Can I remove a List's color while renaming it through v2?”
“Is it possible to change a List's due date and priority in v2?”
Tell an agent
Using v2, rename List {list_id} to {name}.
Set v2 List {list_id} (named {name}) to due {due_date} with priority {priority}, clearing its color: {unset_status}.
DELETE /v2/list/{list_id} Delete a List (v2) · Delete List #
Ask an LLM
“How can I delete a List from my Workspace with v2?”
“What gets removed when a List is deleted via the v2 endpoint?”
Tell an agent destructive · confirm first
Delete List {list_id} via v2.
Remove the v2 List {list_id} from my Workspace.
POST /v2/list/{list_id}/task/{task_id} Add a task to an additional List · Add Task To List #
Ask an LLM
“Can one task live in more than one List at the same time?”
“Which ClickApp must be enabled to put a task in a second List?”
Tell an agent
Add task {task_id} to List {list_id} as an additional List.
Also show task {task_id} in List {list_id} without moving it from its home.
DELETE /v2/list/{list_id}/task/{task_id} Remove a task from an additional List · Remove Task From List #
Ask an LLM
“Can I take a task out of a secondary List while keeping it in its home List?”
“Why can't a task be removed from its home List?”
Tell an agent destructive · confirm first
Remove task {task_id} from the additional List {list_id}.
Stop showing task {task_id} in secondary List {list_id}.
POST /v2/folder/{folder_id}/list_template/{template_id} Create a List from a template in a Folder · Create List From Template in Folder #
Ask an LLM
“Can I spin up a new List in a Folder from one of my List templates?”
“Do public templates need to be added to my Workspace before I use them for a Folder List?”
Tell an agent
Create List {name} in Folder {folder_id} from template {template_id}.
Use List template {template_id} to build {name} inside Folder {folder_id} with options {options}.
POST /v2/space/{space_id}/list_template/{template_id} Create a List from a template in a Space · Create List From Template in Space #
Ask an LLM
“Can a List template be applied directly in a Space, outside any Folder?”
“What options can I pass when generating a Space List from a template?”
Tell an agent
Create List {name} in Space {space_id} from template {template_id}.
Apply List template {template_id} at the Space level of {space_id} as {name}.
GET /folder/{folder_id}/list List a Folder's Lists (legacy path) · Get lists in a folder #
Ask an LLM
“On the older unversioned path, how do I fetch every List under a Folder?”
“Does the legacy Folder lists endpoint return archived ones too?”
Tell an agent
On the legacy path, fetch all Lists under Folder {folder_id}.
Using the older endpoint, pull Folder {folder_id}'s Lists including archived: {archived}.
POST /folder/{folder_id}/list Create a List in a Folder (legacy path) · Create a list in a folder #
Ask an LLM
“Does the legacy unversioned API create Lists under a Folder?”
“On the older path, can a new Folder List get a content description?”
Tell an agent
On the legacy path, make List {name} under Folder {folder_id}.
Using the older endpoint, set up List {name} in {folder_id} with content {content}.
GET /space/{space_id}/list List folderless Lists (legacy path) · Get folderless lists #
Ask an LLM
“On the older unversioned API, where are Lists that sit directly under a Space?”
“Can the legacy path return archived folderless Lists?”
Tell an agent
On the legacy path, fetch Lists sitting directly under Space {space_id}.
Using the older endpoint, pull Space-level Lists for {space_id}, archived: {archived}.
POST /space/{space_id}/list Create a folderless List (legacy path) · Create a folderless list #
Ask an LLM
“Can the older unversioned endpoint make a List right under a Space?”
“On the legacy path, can a Space-level List get a due date?”
Tell an agent
On the legacy path, make Space-level List {name} in {space_id}.
Using the older endpoint, set up List {name} under Space {space_id} due {due_date}.
GET /list/{list_id} Retrieve a List (legacy path) · Get a list #
Ask an LLM
“Does the legacy unversioned List lookup include its statuses?”
“On the older path, how do I read one List's configuration?”
Tell an agent
On the legacy path, read List {list_id} with its statuses.
Using the older endpoint, describe the configuration of List {list_id}.
PUT /list/{list_id} Edit a List (legacy path) · Update a list #
Ask an LLM
“Can the older unversioned endpoint change a List's assignee only?”
“On the legacy path, is the List name optional when editing?”
Tell an agent
On the legacy path, reassign List {list_id} to {assignee}.
Using the older endpoint, retitle List {list_id} as {name} and rewrite its content as {content}.
DELETE /list/{list_id} Delete a List and its tasks (legacy path) · Delete a list #
Ask an LLM
“Does erasing a List on the older unversioned path also destroy all its tasks?”
“Can a List removed through the legacy endpoint be undone?”
Tell an agent destructive · confirm first
Permanently erase List {list_id} and every task in it on the legacy path.
Using the older endpoint, wipe out List {list_id}.
GET /list/{list_id}/member List who has access to a List · Get list members #
Ask an LLM
“Who can see a particular List?”
“Which people have been given access to one List?”
Tell an agent
Show the members with access to List {list_id}.
List everyone who can open List {list_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://artifacts.apis.io/clickup/openapi/clickup-lists-api-openapi.yml
⚙
AsyncAPI
https://artifacts.apis.io/clickup/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:clickup-lists-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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-lists-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Clickup Lists API
  version: '2.0'
  description: 'Operations tagged Lists across 2 of this provider''s published API definitions: clickup-api-v2-reference-openapi.json, clickup-lists-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 (70 KB total) ---
# Full source: https://artifacts.apis.io/clickup/openapi/clickup-lists-api-openapi.yml