# ClickUp API Reference API

> ClickUp API Reference API on Apizie: 126 endpoints (Create Task Attachment, Get Access Token, Get Authorized User, Get Authorized Teams (Workspaces), …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/open-data:clickup/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:clickup`
- Category: Open Data
- Status: byok
- Source: https://clickup.com
- Page: https://www.apizie.tech/api/open-data/clickup
- OpenAPI: https://www.apizie.tech/api/open-data/clickup/openapi.json

This is the ClickUp API Reference where you can learn about specific endpoints and parameters in detail. Browse the available endpoints using the sidebar on the left. **Not sure where to begin?** [Get Started with the…

## Endpoints

### Create Task Attachment
`POST https://www.apizie.tech/v1/open-data:clickup/attachments-upload-file-to-task-as-attachment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by its custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |
| body | object | yes | Form fields as a JSON object |

### Get Access Token
`POST https://www.apizie.tech/v1/open-data:clickup/authorization-get-access-token` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| client_id | string | yes | Oauth app client id |
| client_secret | string | yes | Oauth app client secret |
| code | string | yes | Code given in redirect url |

### Get Authorized User
`GET https://www.apizie.tech/v1/open-data:clickup/authorization-view-account-details` (byok)

### Get Authorized Teams (Workspaces)
`GET https://www.apizie.tech/v1/open-data:clickup/authorization-get-workspace-list` (byok)

### Create Checklist
`POST https://www.apizie.tech/v1/open-data:clickup/task-checklists-create-new-checklist` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |
| body | object | yes | JSON request body |

### Edit Checklist
`POST https://www.apizie.tech/v1/open-data:clickup/task-checklists-update-checklist` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| checklist_id | string | yes | b8a8-48d8-a0c6-b4200788a683 (uuid) |
| body | object | yes | JSON request body |

### Delete Checklist
`POST https://www.apizie.tech/v1/open-data:clickup/task-checklists-remove-checklist` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| checklist_id | string | yes | b8a8-48d8-a0c6-b4200788a683 (uuid) |

### Create Checklist Item
`POST https://www.apizie.tech/v1/open-data:clickup/task-checklists-add-line-item` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| checklist_id | string | yes | b8a8-48d8-a0c6-b4200788a683 (uuid) |
| body | object | yes | JSON request body |

### Edit Checklist Item
`POST https://www.apizie.tech/v1/open-data:clickup/task-checklists-update-checklist-item` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| checklist_id | string | yes | b8a8-48d8-a0c6-b4200788a683 (uuid) |
| checklist_item_id | string | yes | e491-47f5-9fd8-d1dc4cedcc6f (uuid) |
| body | object | yes | JSON request body |

### Delete Checklist Item
`POST https://www.apizie.tech/v1/open-data:clickup/task-checklists-remove-checklist-item` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| checklist_id | string | yes | b8a8-48d8-a0c6-b4200788a683 (uuid) |
| checklist_item_id | string | yes | e491-47f5-9fd8-d1dc4cedcc6f (uuid) |

### Get Task Comments
`GET https://www.apizie.tech/v1/open-data:clickup/comments-get-task-comments` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |
| start | integer | no | Enter the `date` of a task comment using Unix time in milliseconds. |
| start_id | string | no | Enter the Comment `id` of a task comment. |

### Create Task Comment
`POST https://www.apizie.tech/v1/open-data:clickup/comments-create-new-task-comment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |
| body | object | yes | JSON request body |

### Get Chat View Comments
`GET https://www.apizie.tech/v1/open-data:clickup/comments-get-view-comments` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| view_id | string | yes | 105 (string) |
| start | integer | no | Enter the `date` of a Chat view comment using Unix time in milliseconds. |
| start_id | string | no | Enter the Comment `id` of a Chat view comment. |

### Create Chat View Comment
`POST https://www.apizie.tech/v1/open-data:clickup/comments-create-chat-view-comment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| view_id | string | yes | 105 (string) |
| body | object | yes | JSON request body |

### Get List Comments
`GET https://www.apizie.tech/v1/open-data:clickup/comments-get-list-comments` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | number | yes |  |
| start | integer | no | Enter the `date` of a List info comment using Unix time in milliseconds. |
| start_id | string | no | Enter the Comment `id` of a List info comment. |

### Create List Comment
`POST https://www.apizie.tech/v1/open-data:clickup/comments-add-to-list-comment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | number | yes |  |
| body | object | yes | JSON request body |

### Update Comment
`POST https://www.apizie.tech/v1/open-data:clickup/comments-update-task-comment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| comment_id | number | yes |  |
| body | object | yes | JSON request body |

### Delete Comment
`POST https://www.apizie.tech/v1/open-data:clickup/comments-delete-task-comment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| comment_id | number | yes |  |

### Get Accessible Custom Fields
`GET https://www.apizie.tech/v1/open-data:clickup/custom-fields-get-list-fields` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | number | yes |  |

### Set Custom Field Value
`POST https://www.apizie.tech/v1/open-data:clickup/custom-fields-set-field-value` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes | Enter the task ID of the task you want to update. |
| field_id | string | yes | Enter the universal unique identifier (UUID) of the Custom Field you want to set. |
| custom_task_ids | boolean | no | If you want to reference a task by its Custom Task ID, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |
| body | object | yes | JSON request body |

### Remove Custom Field Value
`POST https://www.apizie.tech/v1/open-data:clickup/custom-fields-remove-field-value` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| field_id | string | yes | b8a8-48d8-a0c6-b4200788a683 (uuid) |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |

### Add Dependency
`POST https://www.apizie.tech/v1/open-data:clickup/task-relationships-add-dependency` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes | This is the task which is waiting on or blocking another task. |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`. For example: `custom_task_ids=true&team_id=123`. |
| body | object | yes | JSON request body |

### Delete Dependency
`POST https://www.apizie.tech/v1/open-data:clickup/task-relationships-remove-dependency` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| depends_on | string | yes |  |
| dependency_of | string | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |

### Add Task Link
`POST https://www.apizie.tech/v1/open-data:clickup/task-relationships-link-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| links_to | string | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |

### Delete Task Link
`POST https://www.apizie.tech/v1/open-data:clickup/task-relationships-remove-link-between-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| links_to | string | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |

### Get Folders
`GET https://www.apizie.tech/v1/open-data:clickup/folders-get-contents-of` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| space_id | number | yes |  |
| archived | boolean | no |  |

### Create Folder
`POST https://www.apizie.tech/v1/open-data:clickup/folders-create-new-folder` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| space_id | number | yes |  |
| body | object | yes | JSON request body |

### Get Folder
`GET https://www.apizie.tech/v1/open-data:clickup/folders-get-folder-content` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| folder_id | number | yes |  |

### Update Folder
`POST https://www.apizie.tech/v1/open-data:clickup/folders-rename-folder` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| folder_id | number | yes |  |
| body | object | yes | JSON request body |

### Delete Folder
`POST https://www.apizie.tech/v1/open-data:clickup/folders-remove-folder` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| folder_id | number | yes |  |

### Get Goals
`GET https://www.apizie.tech/v1/open-data:clickup/goals-get-workspace-goals` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| include_completed | boolean | no |  |

### Create Goal
`POST https://www.apizie.tech/v1/open-data:clickup/goals-add-new-goal-to-workspace` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| body | object | yes | JSON request body |

### Get Goal
`GET https://www.apizie.tech/v1/open-data:clickup/goals-get-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| goal_id | string | yes | 900e-462d-a849-4a216b06d930 (uuid) |

### Update Goal
`POST https://www.apizie.tech/v1/open-data:clickup/goals-update-goal-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| goal_id | string | yes | 900e-462d-a849-4a216b06d930 (uuid) |
| body | object | yes | JSON request body |

### Delete Goal
`POST https://www.apizie.tech/v1/open-data:clickup/goals-remove-goal` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| goal_id | string | yes | 900e-462d-a849-4a216b06d930 (uuid) |

### Create Key Result
`POST https://www.apizie.tech/v1/open-data:clickup/goals-add-key-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| goal_id | string | yes | 900e-462d-a849-4a216b06d930 (uuid) |
| body | object | yes | JSON request body |

### Edit Key Result
`POST https://www.apizie.tech/v1/open-data:clickup/goals-update-key-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| key_result_id | string | yes | 8480-49bc-8c57-e569747efe93 (uuid) |
| body | object | yes | JSON request body |

### Delete Key Result
`POST https://www.apizie.tech/v1/open-data:clickup/goals-remove-target` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| key_result_id | string | yes | 8480-49bc-8c57-e569747efe93 (uuid) |

### Invite Guest To Workspace
`POST https://www.apizie.tech/v1/open-data:clickup/guests-invite-to-workspace` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| body | object | yes | JSON request body |

### Get Guest
`GET https://www.apizie.tech/v1/open-data:clickup/guests-get-guest-information` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| guest_id | number | yes |  |

### Edit Guest On Workspace
`POST https://www.apizie.tech/v1/open-data:clickup/guests-edit-guest-on-workspace` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| guest_id | number | yes |  |
| body | object | yes | JSON request body |

### Remove Guest From Workspace
`POST https://www.apizie.tech/v1/open-data:clickup/guests-revoke-guest-access-to-workspace` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| guest_id | number | yes |  |

### Add Guest To Task
`POST https://www.apizie.tech/v1/open-data:clickup/guests-add-to-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| guest_id | number | yes |  |
| include_shared | boolean | no | Exclude details of items shared with the guest by setting this parameter to `false`. By default this parameter is set to `true`. |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |
| body | object | yes | JSON request body |

### Remove Guest From Task
`POST https://www.apizie.tech/v1/open-data:clickup/guests-revoke-access-to-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| guest_id | number | yes |  |
| include_shared | boolean | no | Exclude details of items shared with the guest by setting this parameter to `false`. By default this parameter is set to `true`. |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |

### Add Guest To List
`POST https://www.apizie.tech/v1/open-data:clickup/guests-share-list-with` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | number | yes |  |
| guest_id | number | yes |  |
| include_shared | boolean | no | Exclude details of items shared with the guest by setting this parameter to `false`. By default this parameter is set to `true`. |
| body | object | yes | JSON request body |

### Remove Guest From List
`POST https://www.apizie.tech/v1/open-data:clickup/guests-remove-from-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | number | yes |  |
| guest_id | number | yes |  |
| include_shared | boolean | no | Exclude details of items shared with the guest by setting this parameter to `false`. By default this parameter is set to `true`. |

### Add Guest To Folder
`POST https://www.apizie.tech/v1/open-data:clickup/guests-add-guest-to-folder` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| folder_id | number | yes |  |
| guest_id | number | yes |  |
| include_shared | boolean | no | Exclude details of items shared with the guest by setting this parameter to `false`. By default this parameter is set to `true`. |
| body | object | yes | JSON request body |

### Remove Guest From Folder
`POST https://www.apizie.tech/v1/open-data:clickup/guests-revoke-access-from-folder` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| folder_id | number | yes |  |
| guest_id | number | yes |  |
| include_shared | boolean | no | Exclude details of items shared with the guest by setting this parameter to `false`. By default this parameter is set to `true`. |

### Get Lists
`GET https://www.apizie.tech/v1/open-data:clickup/lists-get-folder-lists` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| folder_id | number | yes |  |
| archived | boolean | no |  |

### Create List
`POST https://www.apizie.tech/v1/open-data:clickup/lists-add-to-folder` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| folder_id | number | yes |  |
| body | object | yes | JSON request body |

### Get Folderless Lists
`GET https://www.apizie.tech/v1/open-data:clickup/lists-get-folderless` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| space_id | number | yes |  |
| archived | boolean | no |  |

### Create Folderless List
`POST https://www.apizie.tech/v1/open-data:clickup/lists-create-folderless-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| space_id | number | yes |  |
| body | object | yes | JSON request body |

### Get List
`GET https://www.apizie.tech/v1/open-data:clickup/lists-get-list-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | number | yes |  |

### Update List
`POST https://www.apizie.tech/v1/open-data:clickup/lists-update-list-info-due-date-priority-assignee-color` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | string | yes |  |
| body | object | yes | JSON request body |

### Delete List
`POST https://www.apizie.tech/v1/open-data:clickup/lists-remove-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | number | yes |  |

### Add Task To List
`POST https://www.apizie.tech/v1/open-data:clickup/lists-add-task-to-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | number | yes |  |
| task_id | string | yes |  |

### Remove Task From List
`POST https://www.apizie.tech/v1/open-data:clickup/lists-remove-task-from-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | number | yes |  |
| task_id | string | yes |  |

### Get Task Members
`GET https://www.apizie.tech/v1/open-data:clickup/members-get-task-access` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |

### Get List Members
`GET https://www.apizie.tech/v1/open-data:clickup/members-get-list-users` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | number | yes |  |

### Get Custom Roles
`GET https://www.apizie.tech/v1/open-data:clickup/roles-list-available-custom-roles` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes |  |
| include_members | boolean | no |  |

### Shared Hierarchy
`GET https://www.apizie.tech/v1/open-data:clickup/shared-hierarchy-view-tasks-lists-folders` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |

### Get Spaces
`GET https://www.apizie.tech/v1/open-data:clickup/spaces-get-space-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| archived | boolean | no |  |

### Create Space
`POST https://www.apizie.tech/v1/open-data:clickup/spaces-add-new-space-to-workspace` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| body | object | yes | JSON request body |

### Get Space
`GET https://www.apizie.tech/v1/open-data:clickup/spaces-get-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| space_id | number | yes |  |

### Update Space
`POST https://www.apizie.tech/v1/open-data:clickup/spaces-update-details-and-enable-click-apps` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| space_id | number | yes |  |
| body | object | yes | JSON request body |

### Delete Space
`POST https://www.apizie.tech/v1/open-data:clickup/spaces-remove-space` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| space_id | number | yes |  |

### Get Space Tags
`GET https://www.apizie.tech/v1/open-data:clickup/tags-get-space` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| space_id | number | yes |  |

### Create Space Tag
`POST https://www.apizie.tech/v1/open-data:clickup/tags-create-space-tag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| space_id | number | yes |  |
| body | object | yes | JSON request body |

### Edit Space Tag
`POST https://www.apizie.tech/v1/open-data:clickup/tags-update-space-tag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| space_id | number | yes |  |
| tag_name | string | yes |  |
| body | object | yes | JSON request body |

### Delete Space Tag
`POST https://www.apizie.tech/v1/open-data:clickup/tags-remove-space-tag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| space_id | number | yes |  |
| tag_name | string | yes |  |
| body | object | yes | JSON request body |

### Add Tag To Task
`POST https://www.apizie.tech/v1/open-data:clickup/tags-add-to-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| tag_name | string | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |

### Remove Tag From Task
`POST https://www.apizie.tech/v1/open-data:clickup/tags-remove-from-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| tag_name | string | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |

### Get Tasks
`GET https://www.apizie.tech/v1/open-data:clickup/tasks-get-list-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | number | yes | To find the list_id: 1. In the Sidebar, hover over the List and click the **ellipsis ...** menu. 2. Select **Copy link.** 3. Use the… |
| archived | boolean | no |  |
| include_markdown_description | boolean | no | To return task descriptions in Markdown format, use `?include_markdown_description=true`. |
| page | integer | no | Page to fetch (starts at 0). |
| order_by | string | no | Order by a particular field. By default, tasks are ordered by `created`.\ \ Options include: `id`, `created`, `updated`, and `due_date`. |
| reverse | boolean | no | Tasks are displayed in reverse order. |
| subtasks | boolean | no | Include or exclude subtasks. By default, subtasks are excluded. |
| statuses | array | no | Filter by statuses. To include closed tasks, use the `include_closed` parameter. \ \ For example: \ \… |
| include_closed | boolean | no | Include or excluse closed tasks. By default, they are excluded.\ \ To include closed tasks, use `include_closed: true`. |
| assignees | array | no | Filter by Assignees. For example: \ \ `?assignees[]=1234&assignees[]=5678` |
| watchers | array | no | Filter by watchers. |
| tags | array | no | Filter by tags. For example: \ \ `?tags[]=tag1&tags[]=this%20tag` |
| due_date_gt | integer | no | Filter by due date greater than Unix time in milliseconds. |
| due_date_lt | integer | no | Filter by due date less than Unix time in milliseconds. |
| date_created_gt | integer | no | Filter by date created greater than Unix time in milliseconds. |
| date_created_lt | integer | no | Filter by date created less than Unix time in milliseconds. |
| date_updated_gt | integer | no | Filter by date updated greater than Unix time in milliseconds. |
| date_updated_lt | integer | no | Filter by date updated less than Unix time in milliseconds. |
| date_done_gt | integer | no | Filter by date done greater than Unix time in milliseconds. |
| date_done_lt | integer | no | Filter by date done less than Unix time in milliseconds. |
| custom_fields | array | no | Include tasks with specific values in multiple Custom Fields.\ \ For example:… |
| custom_items | array | no | Filter by custom task types. For example: \ \ `?custom_items[]=0&custom_items[]=1300` \ \ Including `0` returns tasks. Including `1`… |

### Create Task
`POST https://www.apizie.tech/v1/open-data:clickup/tasks-create-new-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | number | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by its custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |
| body | object | yes | JSON request body |

### Get Task
`GET https://www.apizie.tech/v1/open-data:clickup/tasks-get-task-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by its custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |
| include_subtasks | boolean | no | Include subtasks, default false |
| include_markdown_description | boolean | no | To return task descriptions in Markdown format, use `?include_markdown_description=true`. |

### Update Task
`POST https://www.apizie.tech/v1/open-data:clickup/tasks-update-task-fields` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by its custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |
| body | object | yes | JSON request body |

### Delete Task
`POST https://www.apizie.tech/v1/open-data:clickup/tasks-remove-task-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by its custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |

### Get Filtered Team Tasks
`GET https://www.apizie.tech/v1/open-data:clickup/tasks-filter-team-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_Id | number | yes | Team ID (Workspace) |
| page | integer | no | Page to fetch (starts at 0). |
| order_by | string | no | Order by a particular field. By default, tasks are ordered by `created`.\ \ Options include: `id`, `created`, `updated`, and `due_date`. |
| reverse | boolean | no | Tasks are displayed in reverse order. |
| subtasks | boolean | no | Include or exclude subtasks. By default, subtasks are excluded. |
| space_ids | array | no | Filter by Spaces. For example: \ \ `?space_ids[]=1234&space_ids[]=6789` |
| project_ids | array | no | Filter by Folders. For example: \ \ `?project_ids[]=1234&project_ids[]=6789` |
| list_ids | array | no | Filter by Lists. For example: \ \ `?list_ids[]=1234&list_ids[]=6789` |
| statuses | array | no | Filter by statuses. Use `%20` to represent a space character. To include closed tasks, use the `include_closed` parameter. \ \ For… |
| include_closed | boolean | no | Include or excluse closed tasks. By default, they are excluded.\ \ To include closed tasks, use `include_closed: true`. |
| assignees | array | no | Filter by Assignees using people's ClickUp user id. For example: \ \ `?assignees[]=1234&assignees[]=5678` |
| tags | array | no | Filter by tags. User `%20` to represent a space character. For example: \ \ `?tags[]=tag1&tags[]=this%20tag` |
| due_date_gt | integer | no | Filter by due date greater than Unix time in milliseconds. |
| due_date_lt | integer | no | Filter by due date less than Unix time in milliseconds. |
| date_created_gt | integer | no | Filter by date created greater than Unix time in milliseconds. |
| date_created_lt | integer | no | Filter by date created less than Unix time in milliseconds. |
| date_updated_gt | integer | no | Filter by date updated greater than Unix time in milliseconds. |
| date_updated_lt | integer | no | Filter by date updated less than Unix time in milliseconds. |
| date_done_gt | integer | no | Filter by date done greater than Unix time in milliseconds. |
| date_done_lt | integer | no | Filter by date done less than Unix time in milliseconds. |
| custom_fields | array | no | Include tasks with specific values in one or more Custom Fields.\ \ For example:… |
| custom_task_ids | boolean | no | If you want to reference a task by its custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |
| parent | string | no | Include the parent task ID to return subtasks. |
| include_markdown_description | boolean | no | To return task descriptions in Markdown format, use `?include_markdown_description=true`. |
| custom_items | array | no | Filter by custom task types. For example: \ \ `?custom_items[]=0&custom_items[]=1300` \ \ Including `0` returns tasks. Including `1`… |

### Get Task's Time in Status
`GET https://www.apizie.tech/v1/open-data:clickup/tasks-get-time-in-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |

### Get Bulk Tasks' Time in Status
`GET https://www.apizie.tech/v1/open-data:clickup/tasks-get-time-in-status-bulk` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_ids | string | yes | Include this paramater once per `task_id`. You can include up to 100 task ids per request. For example: `task_ids=3cuh&task_ids=g4fs` |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |

### Get Task Templates
`GET https://www.apizie.tech/v1/open-data:clickup/task-templates-get-templates` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| page | integer | yes |  |

### Create Task From Template
`POST https://www.apizie.tech/v1/open-data:clickup/task-templates-create-from-template` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | number | yes |  |
| template_id | string | yes |  |
| body | object | yes | JSON request body |

### Get Workspace seats
`GET https://www.apizie.tech/v1/open-data:clickup/teams-workspaces-get-workspace-seats` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | string | yes | Team ID (Workspace) |

### Get Workspace Plan
`GET https://www.apizie.tech/v1/open-data:clickup/teams-workspaces-get-workspace-plan` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | string | yes | Team ID (Workspace) |

### Create Team
`POST https://www.apizie.tech/v1/open-data:clickup/teams-user-groups-create-team` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| body | object | yes | JSON request body |

### Get Custom Task Types
`GET https://www.apizie.tech/v1/open-data:clickup/custom-task-types-get-available-task-types` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |

### Update Team
`POST https://www.apizie.tech/v1/open-data:clickup/teams-user-groups-update-user-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| group_id | string | yes | 7C73-4002-A6A9-310014852858 (string) - Team ID (user group) |
| body | object | yes | JSON request body |

### Delete Team
`POST https://www.apizie.tech/v1/open-data:clickup/teams-user-groups-remove-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| group_id | string | yes | 7C73-4002-A6A9-310014852858 (string) - Team ID (user group) |

### Get Teams
`GET https://www.apizie.tech/v1/open-data:clickup/teams-user-groups-get-user-groups` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | no | Team ID (Workspace) |
| group_ids | string | no | Enter one or more Team ids (user groups) to retrieve information about specific Teams. |

### Get tracked time
`GET https://www.apizie.tech/v1/open-data:clickup/time-tracking-legacy-get-tracked-time` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |

### Track time
`POST https://www.apizie.tech/v1/open-data:clickup/time-tracking-legacy-record-time-for-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |
| body | object | yes | JSON request body |

### Edit time tracked
`POST https://www.apizie.tech/v1/open-data:clickup/time-tracking-legacy-edit-time-tracked` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| interval_id | string | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |
| body | object | yes | JSON request body |

### Delete time tracked
`POST https://www.apizie.tech/v1/open-data:clickup/time-tracking-legacy-remove-tracked-time` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | yes |  |
| interval_id | string | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |

### Get time entries within a date range
`GET https://www.apizie.tech/v1/open-data:clickup/time-tracking-get-time-entries-within-date-range` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_Id | number | yes | Team ID (Workspace) |
| start_date | number | no | Unix time in milliseconds |
| end_date | number | no | Unix time in milliseconds |
| assignee | number | no | Filter by `user_id`. For multiple assignees, separate `user_id` using commas.\ \ **Example:** `assignee=1234,9876`\ \ ***Note:** Only… |
| include_task_tags | boolean | no | Include task tags in the response for time entries associated with tasks. |
| include_location_names | boolean | no | Include the names of the List, Folder, and Space along with the `list_id`,`folder_id`, and `space_id`. |
| space_id | number | no | Only include time entries associated with tasks in a specific Space. |
| folder_id | number | no | Only include time entries associated with tasks in a specific Folder. |
| list_id | number | no | Only include time entries associated with tasks in a specific List. |
| task_id | string | no | Only include time entries associated with a specific task. |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |
| is_billable | boolean | no | Include only billable time entries by using a value of `true` or only non-billable time entries by using a value of `false`.\ \ For… |

### Create a time entry
`POST https://www.apizie.tech/v1/open-data:clickup/time-tracking-create-time-entry` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_Id | number | yes | Team ID (Workspace) |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |
| body | object | yes | JSON request body |

### Get singular time entry
`GET https://www.apizie.tech/v1/open-data:clickup/time-tracking-get-single-time-entry` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| timer_id | string | yes | The ID of a time entry. \ \ This can be found using the [Get Time Entries Within a Date Range](https://clickup.com/api) endpoint. |
| include_task_ | boolean | no | Include task in the response for time entries associated with tasks. |
| include_location_names | boolean | no | Include the names of the List, Folder, and Space along with `list_id`,`folder_id`, and `space_id`. |

### Update a time Entry
`POST https://www.apizie.tech/v1/open-data:clickup/time-tracking-update-time-entry-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| timer_id | number | yes |  |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the parameter is set to `custom_task_ids=true`\ \ For example: `custom_task_ids=true&team_id=123` |
| body | object | yes | JSON request body |

### Delete a time Entry
`POST https://www.apizie.tech/v1/open-data:clickup/time-tracking-remove-entry` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| timer_id | number | yes | Array of timer ids to delete separated by commas |

### Get time entry history
`GET https://www.apizie.tech/v1/open-data:clickup/time-tracking-get-time-entry-history` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| timer_id | string | yes | The ID of a time entry. \ \ This can be found using the [Get Time Entries Within a Date… |

### Get running time entry
`GET https://www.apizie.tech/v1/open-data:clickup/time-tracking-get-current-time-entry` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| assignee | number | no | user id |

### Get all tags from time entries
`GET https://www.apizie.tech/v1/open-data:clickup/time-tracking-get-all-tags-from-time-entries` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |

### Add tags from time entries
`POST https://www.apizie.tech/v1/open-data:clickup/time-tracking-add-tags-from-time-entries` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| body | object | yes | JSON request body |

### Change tag names from time entries
`POST https://www.apizie.tech/v1/open-data:clickup/time-tracking-change-tag-names` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| body | object | yes | JSON request body |

### Remove tags from time entries
`POST https://www.apizie.tech/v1/open-data:clickup/time-tracking-remove-tags-from-time-entries` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| body | object | yes | JSON request body |

### Start a time Entry
`POST https://www.apizie.tech/v1/open-data:clickup/time-tracking-start-timer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_Id | number | yes | Team ID (Workspace) |
| custom_task_ids | boolean | no | If you want to reference a task by it's custom task id, this value must be `true`. |
| team_id | number | no | Only used when the `custom_task_ids` parameter is set to `true`.\ \ For example: `custom_task_ids=true&team_id=123`. |
| body | object | yes | JSON request body |

### Stop a time Entry
`POST https://www.apizie.tech/v1/open-data:clickup/time-tracking-stop-time-entry` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |

### Invite User To Workspace
`POST https://www.apizie.tech/v1/open-data:clickup/users-invite-user-to-workspace` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| body | object | yes | JSON request body |

### Get User
`GET https://www.apizie.tech/v1/open-data:clickup/users-get-user-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| user_id | number | yes |  |

### Edit User On Workspace
`POST https://www.apizie.tech/v1/open-data:clickup/users-update-user-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| user_id | number | yes |  |
| body | object | yes | JSON request body |

### Remove User From Workspace
`POST https://www.apizie.tech/v1/open-data:clickup/users-deactivate-from-workspace` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| user_id | number | yes |  |

### Get Workspace (Everything level) Views
`GET https://www.apizie.tech/v1/open-data:clickup/views-get-everything-level` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |

### Create Workspace (Everything level) View
`POST https://www.apizie.tech/v1/open-data:clickup/views-create-workspace-view-everything-level` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| team_id | number | yes | Team ID (Workspace) |
| body | object | yes | JSON request body |

### Get Space Views
`GET https://www.apizie.tech/v1/open-data:clickup/views-space-views-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| space_id | number | yes |  |

### Create Space View
`POST https://www.apizie.tech/v1/open-data:clickup/views-add-view-to-space` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| space_id | number | yes |  |
| body | object | yes | JSON request body |

### Get Folder Views
`GET https://www.apizie.tech/v1/open-data:clickup/views-folder-views-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| folder_id | number | yes |  |

### Create Folder View
`POST https://www.apizie.tech/v1/open-data:clickup/views-add-view-to-folder` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| folder_id | number | yes |  |
| body | object | yes | JSON request body |

### Get List Views
`GET https://www.apizie.tech/v1/open-data:clickup/views-get-list-views` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | number | yes |  |

### Create List View
`POST https://www.apizie.tech/v1/open-data:clickup/views-add-view-to-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| list_id | number | yes |  |
| body | object | yes | JSON request body |

### Get View
`GET https://www.apizie.tech/v1/open-data:clickup/views-get-view-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| view_id | string | yes |  |

### Update View
`POST https://www.apizie.tech/v1/open-data:clickup/views-update-view-details` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| view_id | string | yes |  |
| body | object | yes | JSON request body |

…and 6 more. See the OpenAPI spec.

## Example
```
curl "https://www.apizie.tech/v1/open-data:clickup/attachments-upload-file-to-task-as-attachment" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the ClickUp API Reference API?
Create a free Apizie key, then send POST https://www.apizie.tech/v1/open-data:clickup/attachments-upload-file-to-task-as-attachment with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the ClickUp API Reference API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. ClickUp API Reference itself also needs your own key from api.clickup.com.

### Can AI agents use the ClickUp API Reference API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key open-data:clickup.

### What is the status of the ClickUp API Reference API?
Needs your own provider key (bring your own key)