Exploring your Workspace

The ClickUp API uses the same ClickUp hierarchy to allow you to explore your Workspaces.

Find Workspaces

Use the Get Authorized Teams endpoint to list each Workspace you have created or joined.

You'll use the team (Workspace) id that's included in the response body to:

• Navigate through the hierarchy
• Find tasks from anywhere in your Workspace using the Get Filtered Team tasks endpoint.

Find Spaces

Use the Get Spaces endpoint to list each Space in a given Workspace.

You'll use the Space id that's included in the response body to find Folders and Folderless Lists.

Find Folders

Use the Get Folders endpoint to list each Folder in a given Space.

You'll use the Folder id that's included in the response body to find Lists in a given Folder.

Find Lists

There's two ways to find Lists, depending on wheter or not they are in a Folder or not.

You'll use the List id from the following endpoints to:

• Find the tasks in a given List
• Find the available Custom Fields using the Get Accessible Custom Fields endpoint.

Find folderless Lists

Use the Get Folderless Lists endpoint to find the Folderless Lists in a given Space.

Find Lists in Folders

Use the Get Lists endpoint to find the Lists in a given Folder.

Find tasks

Now you can use the Get Tasks endpoint to find tasks in a given List.