clickup Views API
Operations for managing views at various levels of the ClickUp hierarchy.
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}.
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}.
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}.
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}.
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}.
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}.
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}.
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.
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}.
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.
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}.
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}.
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.
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}.
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}.
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}.
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}.
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}.
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