---
updatedAt: 2025-09-04T18:39:22.000Z
---

Fetch the complete documentation index at: https://developer.clickup.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Views

Work with views using the ClickUp API.

# Views

You can create, update, delete, group, sort, and [filter views](https://developer.clickup.com/docs/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](https://developer.clickup.com/reference/getviewtasks).

> 👍 Tip
>
> Explore the [View endpoints](https://developer.clickup.com/reference/createteamview).

## View Type

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

* `list`
* `board`
* `calendar`
* `gantt`

<Callout icon="👀" theme="default">
  ### Note

  Page views, such as <Glossary>Docs</Glossary> and Whiteboards, are not supported through the public API.
</Callout>

## View Parent

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

The available `parent.type` values are:

* Team (everything level): 7
* <Glossary>Space</Glossary>: 4
* <Glossary>Folder</Glossary>: 5
* <Glossary>List</Glossary>: 6

## View Object Example

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