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