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

Copy

Copied

{
    "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"
            }
        ]
    }
}