Views

You can create, update, delete, group, sort, and filter views at any level of the ClickUp hierarchy using the API.

To get task information displayed in a view, use the Get View Tasks endpoint.

👍
Tip
Explore the View endpoints.

View Type

The view type determines the view's format. Supported values are:

list
board
calendar
gantt

👀
Note
Page views, such as Docs and Whiteboards, are not supported through the public API.

View Parent

The parent parameter specifies where the view is located in the ClickUp hierarchy and must include the ID of the Workspace, Space, Folder, or List.

The available parent.type values are:

Team (everything level): 7
Space: 4
Folder: 5
List: 6

View Object Example

{
    "name": "View Name",
    "type": "list",
    "parent": {
        "id": 333,
        "type": 7
    },
    "grouping": {
        "field": "status",
        "dir": 1
    },
    "filters": {
        "op": "AND",
        "fields": [
            {
                "field": "assignee",
                "op": "EQ",
                "values": []
            }
        ],
        "search": "",
        "show_closed": false
    },
    "sorting": {
        "fields": [
            {
                "field": "dateCreated",
                "dir": -1
            }
        ]
    },
    "columns": {
        "fields": [
            {
                "field": "dateCreated"
            }
        ]
    }
}