Clickup

clickup Views API

Operations for managing views at various levels of the ClickUp hierarchy.

GitHub OpenAPI

Operations 20

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/team/{team_id}/view List Everything-level views (v2) · Get Workspace (Everything level) Views #
Ask an LLM
“Which views live at the Everything level of my ClickUp Workspace?”
“Can I see the Workspace-wide task and page views through the v2 API?”
Tell an agent
List the Everything-level views in Workspace {team_id} via v2.
Show all task and page views pinned at the top of Workspace {team_id}.
POST /v2/team/{team_id}/view Create an Everything-level view · Create Workspace (Everything level) View #
Ask an LLM
“Can I add a Gantt or Workload view that spans the entire Workspace?”
“What settings must I pass when creating a Workspace-wide view?”
Tell an agent
Create a {type} view named {name} at the Everything level of Workspace {team_id}.
Add a Workspace-wide board called {name} to {team_id} grouped by {grouping} and filtered by {filters}.
GET /v2/space/{space_id}/view List a Space's views (v2) · Get Space Views #
Ask an LLM
“What board, list and calendar views are set up on a given Space?”
“How do I see the views attached to one Space through v2?”
Tell an agent
List the v2 views on Space {space_id}.
Show every task and page view configured for Space {space_id}.
POST /v2/space/{space_id}/view Add a view to a Space · Create Space View #
Ask an LLM
“Can I add a Calendar or Timeline view to a Space programmatically?”
“Which view types can be created on a Space?”
Tell an agent
Add a {type} view named {name} to Space {space_id}.
Create a Space view {name} on {space_id} sorted by {sorting} with columns {columns}.
GET /v2/folder/{folder_id}/view List a Folder's views (v2) · Get Folder Views #
Ask an LLM
“What views does a particular Folder have?”
“Can the v2 API show me the page and task views on one Folder?”
Tell an agent
List the v2 views on Folder {folder_id}.
Show the board, table and calendar views inside Folder {folder_id}.
POST /v2/folder/{folder_id}/view Add a view to a Folder · Create Folder View #
Ask an LLM
“Can I add a Table view to a Folder with specific columns?”
“What does it take to create a Map or Activity view on a Folder?”
Tell an agent
Add a {type} view called {name} to Folder {folder_id}.
Create Folder view {name} on {folder_id} divided by {divide} and filtered with {filters}.
GET /v2/list/{list_id}/view List a List's views (v2) · Get List Views #
Ask an LLM
“Which views exist on a single List, including the required ones?”
“Does the v2 List views response separate required views from the rest?”
Tell an agent
List the v2 views on List {list_id}, including required views.
Show what views are configured for List {list_id}.
POST /v2/list/{list_id}/view Add a view to a List · Create List View #
Ask an LLM
“Can I add a Board view to one List with my own grouping?”
“Is there a way to create a Gantt view scoped to a single List?”
Tell an agent
Add a {type} view named {name} to List {list_id}.
Create a List view {name} on {list_id} grouped by {grouping} with settings {settings}.
GET /v2/view/{view_id} Retrieve a view's details (v2) · Get View #
Ask an LLM
“What filters and grouping does a specific view use, per the v2 API?”
“Does the information returned about a view depend on its type?”
Tell an agent
Get the v2 details of view {view_id}.
Show the configuration of view {view_id} as the v2 API reports it.
PUT /v2/view/{view_id} Reconfigure a view (v2) · Update View #
Ask an LLM
“Can I rename a view and change its sorting at the same time with v2?”
“Which fields must be resent when updating a view through v2?”
Tell an agent
Using v2, rename view {view_id} to {name} and set its filters to {filters}.
Change v2 view {view_id} to type {type} under parent {parent} with columns {columns}.
DELETE /v2/view/{view_id} Delete a view (v2) · Delete View #
Ask an LLM
“How can I get rid of a view nobody uses anymore via the v2 API?”
“Does removing a view with v2 delete the tasks it shows?”
Tell an agent destructive · confirm first
Delete v2 view {view_id}.
Remove the unused view {view_id} using the v2 endpoint.
GET /v2/view/{view_id}/task List tasks visible in a view (v2) · Get View Tasks #
Ask an LLM
“Which tasks does a saved view currently show?”
“Is the v2 view tasks list paginated?”
Tell an agent
Get page {page} of the tasks visible in view {view_id} via v2.
List the first page of tasks in v2 view {view_id}.
GET /team/{team_id}/view List Workspace-level views (legacy path) · Get team views #
Ask an LLM
“On the older unversioned path, what views span every Space in a Workspace?”
“Does the legacy API expose team-level views?”
Tell an agent
On the legacy path, fetch team-level views that span all Spaces in {team_id}.
Using the older endpoint, enumerate cross-Space views for Workspace {team_id}.
GET /space/{space_id}/view List a Space's views (legacy path) · Get space views #
Ask an LLM
“Does the legacy unversioned API return the views within a Space?”
“On the older endpoint, how are Space views retrieved?”
Tell an agent
On the legacy path, fetch views within Space {space_id}.
Using the older endpoint, enumerate Space {space_id} views.
GET /folder/{folder_id}/view List a Folder's views (legacy path) · Get folder views #
Ask an LLM
“Does the older unversioned path list views inside a Folder?”
“On the legacy API, where do I find a Folder's saved views?”
Tell an agent
On the legacy path, fetch views within Folder {folder_id}.
Using the older endpoint, enumerate saved views in Folder {folder_id}.
GET /list/{list_id}/view List a List's views (legacy path) · Get list views #
Ask an LLM
“Can the older unversioned API tell me which views a List has?”
“On the legacy path, how do I read a List's saved views?”
Tell an agent
On the legacy path, fetch views within List {list_id}.
Using the older endpoint, enumerate saved views in List {list_id}.
GET /view/{view_id} Retrieve a view (legacy path) · Get a view #
Ask an LLM
“On the older unversioned path, how do I read one view's filters, sorting and columns?”
“Does the legacy view lookup include its grouping setup?”
Tell an agent
On the legacy path, read view {view_id} with its filters, sorting and columns.
Using the older endpoint, describe the setup of view {view_id}.
PUT /view/{view_id} Reconfigure a view (legacy path) · Update a view #
Ask an LLM
“Can the older unversioned endpoint change just a view's name without the other fields?”
“On the legacy path, can I adjust a view's grouping only?”
Tell an agent
On the legacy path, retitle view {view_id} as {name}.
Using the older endpoint, regroup view {view_id} by {grouping} and sort it by {sorting}.
DELETE /view/{view_id} Delete a view (legacy path) · Delete a view #
Ask an LLM
“Is removing a view through the older unversioned endpoint permanent?”
“Can a view erased on the legacy path be restored?”
Tell an agent destructive · confirm first
Permanently erase view {view_id} on the legacy path.
Using the older endpoint, wipe out view {view_id}.
GET /view/{view_id}/task List tasks in a view (legacy path) · Get view tasks #
Ask an LLM
“On the older unversioned path, does the view's filtering and sorting apply to the returned tasks?”
“Can the legacy API page through a view's tasks?”
Tell an agent
On the legacy path, fetch tasks shown by view {view_id} with its filters applied.
Using the older endpoint, get page {page} of view {view_id}'s tasks.

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-views-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-views-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-views-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Clickup Views API
  version: '2.0'
  description: 'Operations tagged Views across 2 of this provider''s published API definitions: clickup-api-v2-reference-openapi.json, clickup-views-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 (116 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/openapi/clickup-views-api-openapi.yml