List Workspace Tasks

clickup.list_team_tasks

ActionBusiness appsconnection required

Calls the ClickUp API with the connection's credentials.

Search tasks across a whole Workspace by team id, narrowed to given Spaces, Folders or Lists. This is the only way to list a Space's tasks — ClickUp has no per-Space task endpoint.

Ask about ClickUp All ClickUp nodes Provider API docs ↗

Connection

Required: Yes — the node will not save without one
Auth type: API key
Providers: ClickUp
Secret shape: the API token (pk_…), or {"token": "…"}
Config it needs: list_id
Resolved by: config.connection_id, else node.connection_id

Configuration

12 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

Field	Type	Required	Default	Constraints	Example
team_id The Workspace (team) id — the first number in any ClickUp URL, or clickup.list_teams.	string	Yes	—	—	—
space_ids Only tasks in these Space ids.	array	No	—	array of string	—
folder_ids Only tasks in these Folder ids (ClickUp calls them project_ids).	array	No	—	array of string	—
list_ids Only tasks in these List ids.	array	No	—	array of string	—
statuses Only tasks in these statuses, by name.	array	No	—	array of string	—
assignees Only tasks assigned to these user ids.	array	No	—	array of string	—
tags Only tasks carrying these tag names.	array	No	—	array of string	—
page Page to fetch; ClickUp returns 100 tasks per page and pages start at 0.	integer	No	0	≥ 0	—
include_closed Include tasks in a closed status.	boolean	No	false	—	—
subtasks Include subtasks alongside their parents.	boolean	No	false	—	—
order_by Field to sort by. ClickUp accepts id, created, updated or due_date.	string	No	—	one of "id", "created", "updated", "due_date"	—
reverse Reverse the sort order.	boolean	No	false	—	—

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "include_closed": false,
  "page": 0,
  "reverse": false,
  "subtasks": false
}

Output

One shape.

result

Field	Type	Example
items One entry per row ClickUp returned.	array	—
count How many rows are in items.	number	—
last_page True when ClickUp says this was the final page; null when it did not say, which is not the same as 'no more rows'.	boolean	—

{
  "count": 0,
  "items": [],
  "last_page": false
}

Notes

Responses are capped at 100 tasks; raise page to walk the rest. last_page is null here unless ClickUp sends it.

Related ClickUp nodes

See List Workspace Tasks run in a workflow.

In a technical demo we add the ClickUp connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.

Book a technical demo Talk to sales