ClickUp unifies tasks, docs, goals, and chat in a single platform, allowing teams to plan, organize, and collaborate across projects with customizable workflows
Create webhook
Set up a webhook to monitor for events.we do not have a dedicated ip address for webhooks. we use our domain name and dynamic addressing.
Change tag names from time entries
Rename an time entry label.
Delete checklist item
Delete a line item from a task checklist.
Add guest to list
Share a list with a guest. note: this endpoint is only available to workspaces on our enterprise plan.
Delete a time entry
Delete a time entry from a workspace.
Get authorized teams workspaces
View the workspaces available to the authenticated user.<<DEPRECATED use get_authorized_teams_workspaces>>
Create folder view
Add a list, board, calendar, table, timeline, workload, activity, map, chat, or gantt view to a folder.
Add guest to task
Share a task with a guest. note: this endpoint is only available to workspaces on our enterprise plan.
Create space view
Add a list, board, calendar, table, timeline, workload, activity, map, chat, or gantt view to a space.
Get authorized user
View the details of the authenticated user’s clickup account.<<DEPRECATED use get_authorized_user>>
Delete comment
Delete a task comment.
Delete checklist
Delete a checklist from a task.
Create workspace everything level view
Add a list, board, calendar, table, timeline, workload, activity, map, chat, or gantt view at the everything level of a workspace.
Create task
Create a new task.
Delete folder
Delete a folder from your workspace.
Delete key result
Delete a target from a goal.
Delete list
Delete a list from your workspace.
Create goal
Add a new goal to a workspace.
Delete goal
Remove a goal from your workspace.
Create a time entry
Create a time entry. note: a time entry that has a negative duration means that timer is currently running for that user.
Create chat view comment
Add a new comment to a chat view.
Add tags from time entries
Add a label to a time entry.
Create task attachment
Upload a file to a task as an attachment. note: this request uses multipart/form-data as the content type.
Delete space
Delete a space from your workspace.
Delete space tag
Delete a task tag from a space.
Delete dependency
Remove the dependency relationship between two or more tasks.
Create task comment
Add a new comment to a task.
Delete task link
Remove the link between two tasks.
Delete task
Delete a task from your workspace.
Add tag to task
Add a tag to a task.
Delete team
This endpoint removes a user group from a workspace, per clickup documentation. team id is the workspace id, and group id is the user group id.
Create key result
Add a target to a goal.
Add dependency
Set a task as waiting on or blocking another task.
Create task from template
Create a new task using a task template.
Create checklist
Add a new checklist to a task.
Delete time tracked
note: this is a legacy time tracking endpoint. we recommend using the time tracking api endpoints to manage time entries.
Delete webhook
Delete a webhook to stop monitoring the events and locations of the webhook.
Delete view
Deletes a specific view by its id. requires ‘view id’ as a string parameter in the path. successful deletion returns 200 with an empty json object.
Add task link
Link two tasks together.
Edit checklist
Rename a task checklist, or reorder a checklist so it appears above or below other checklists on a task.
Share a folder with a guest. note: this endpoint is only available to workspaces on our enterprise plan.
Create folder
Add a new folder to a space.<<DEPRECATED use create_folder>>
Create task attachment
Upload a file to a task as an attachment. note: this request uses multipart/form-data as the content type.<<DEPRECATED use create_task_attachment>>
Get folder
View the lists within a folder.<<DEPRECATED use get_folder>>
Edit checklist item
Update an individual line item in a task checklist. you can rename it, set the assignee, mark it as resolved, or nest it under another checklist item.
Create list
Add a new list to a folder.
Get access token
The text outlines api authentication via personal tokens and oauth flow, stating oauth tokens can’t be used in “try it” feature or tested via web browsers.<<DEPRECATED use get_access_token>>
Get authorized user
View the details of the authenticated user’s clickup account.
Create team
The endpoint allows creating teams within workspaces, assigning tasks, and managing ids for both. adding a view-only guest as a paid member may result in extra charges due to automatic seat addition.
Get chat view comments
View comments from a chat view. if you do not include the start and start id parameters, this endpoint will return the most recent 25 comments. use the start and start id parameters of the oldest comment to retrieve the next 25 comments.
Get accessible custom fields
View the custom fields available on tasks in a specific list.
Get authorized teams workspaces
View the workspaces available to the authenticated user.
Get folders
View the folders in a space.<<DEPRECATED use get_folders>>
Get access token
The text outlines api authentication via personal tokens and oauth flow, stating oauth tokens can’t be used in “try it” feature or tested via web browsers.
Get all tags from time entries
View all the labels that have been applied to time entries in a workspace.
Get bulk tasks time in status
View how long two or more tasks have been in each status.
Get custom task types
View the custom task types available in a workspace.
Edit user on workspace
Update a user’s name and role. note: this endpoint is only available to workspaces on our enterprise plan.
Create list comment
Add a comment to a list.
Get folder
View the lists within a folder.
Get folderless lists
View the lists in a space that aren’t located in a folder.
Edit space tag
Update a task tag.
Get custom roles
View the custom roles available in a workspace.
Get filtered team tasks
View the tasks that meet specific criteria from a workspace. responses are limited to 100 tasks per page. you can only view task information of tasks you can access.
Edit time tracked
note: this is a legacy time tracking endpoint. we recommend using the time tracking api endpoints to manage time entries.
Create folderless list
Add a new list in a space.
Edit guest on workspace
Rename and configure options for a guest. note: this endpoint is only available to workspaces on our enterprise plan.
Create space
Add a new space to a workspace.
Create list view
Add a list, board, calendar, table, timeline, workload, activity, map, chat, or gantt view to a list.
Create space tag
Add a new task tag to a space.
Create folder
Add a new folder to a space.
Get space tags
View the task tags available in a space.
Get task s time in status
View how long a task has been in each status. the total time in status clickapp must first be enabled by the workspace owner or an admin.
Get guest
View information about a guest. note: this endpoint is only available to workspaces on our enterprise plan.
Get folders
View the folders in a space.
Get list members
View the people who have access to a list.
Get spaces
View the spaces avialable in a workspace. you can only get member info in private spaces.
Get folder views
View the task and page views available for a folder.
Get list views
View the task and page views available for a list.views and required views are separate responses.
Get goals
View the goals available in a workspace.
Get task templates
View the task templates available in a workspace.
Get space
View the spaces available in a workspace.
Get task
View information about a task. you can only view task information of tasks you can access. tasks with attachments will return an “attachments” response.
Get tasks
This api endpoint allows viewing up to 100 tasks per page, limited to tasks within the specified list id that have it as their home list. tasks from other home lists aren’t included.
Get goal
View the details of a goal including its targets.
Get list
View information about a list.
Get task members
View the people who have access to a task.
Get running time entry
View a time entry that’s currently tracking time for the authenticated user. note: a time entry that has a negative duration means that timer is currently running for that user.
Get workspace seats
View the used, total, and available member and guest seats for a workspace.
Get view
View information about a specific task or page view.
Get view tasks
See all visible tasks in a view in clickup.
Get singular time entry
View a single time entry. note: a time entry that has a negative duration means that timer is currently running for that user.
Get tracked time
note: this is a legacy time tracking endpoint. we recommend using the time tracking api endpoints to manage time entries.
Get task comments
View task comments. if you do not include the start and start id parameters, this endpoint will return the most recent 25 comments. use the start and start id parameters of the oldest comment to retrieve the next 25 comments.
Get time entry history
View a list of changes made to a time entry.
Remove custom field value
Remove the data from a custom field on a task. this does not delete the option from the custom field.
Remove guest from folder
Revoke a guest’s access to a folder. note: this endpoint is only available to workspaces on our enterprise plan.
Invite guest to workspace
To invite a guest to your workspace, use the “invite user to workspace” endpoint. then, use specific endpoints to grant access to folders, lists, or tasks. note: available only for enterprise plan.
Get list comments
To view comments on a list, omitting start and start id shows the latest 25 comments. for earlier ones, use the start and start id of the oldest comment to get the next 25.
Remove user from workspace
Deactivate a user from a workspace. note: this endpoint is only available to workspaces on our enterprise plan.
Get space
View the spaces available in a workspace.<<DEPRECATED use get_space>>
Get space views
View the task and page views available for a space.
Get lists
View the lists within a folder.
Remove task from list
This api endpoint allows for removing a task from an extra list, not its original list, requiring the tasks in multiple list clickapp to be enabled.
Get spaces
View the spaces avialable in a workspace. you can only get member info in private spaces.<<DEPRECATED use get_spaces>>
Start a time entry
Start a timer for the authenticated user.
Invite user to workspace
Invite someone to your workspace as a member through a specific endpoint. note: guest invitations and this feature are exclusive to workspaces on the enterprise plan.
Get task
View information about a task. you can only view task information of tasks you can access. tasks with attachments will return an “attachments” response.<<DEPRECATED use get_task>>
Get lists
View the lists within a folder.<<DEPRECATED use get_lists>>
Get workspace plan
View the current plan for the specified workspace.<<DEPRECATED use get_workspace_plan>>
Stop a time entry
Stop a timer that’s currently running for the authenticated user.
Set custom field value
To add data to a task’s custom field, obtain the task id and the custom field’s field id (uuid). use the “get accessible custom fields” or “get task” api endpoints to find the field id.
Create checklist
Add a new checklist to a task.<<DEPRECATED use create_checklist>>
Shared hierarchy
View the tasks, lists, and folders that have been shared with the authenticated user.
Get workspace seats
View the used, total, and available member and guest seats for a workspace.<<DEPRECATED use get_workspace_seats>>
Get tasks
This api endpoint allows viewing up to 100 tasks per page, limited to tasks within the specified list id that have it as their home list. tasks from other home lists aren’t included.<<DEPRECATED use get_tasks>>
Update folder
Rename a folder.
Track time
note: this is a legacy time tracking endpoint. we recommend using the time tracking api endpoints to manage time entries.
Update goal
Rename a goal, set the due date, replace the description, add or remove owners, and set the goal color.
Update comment
Replace the content of a task commment, assign a comment, and mark a comment as resolved.
Update a time entry
Update the details of a time entry.
Create team
The endpoint allows creating teams within workspaces, assigning tasks, and managing ids for both. adding a view-only guest as a paid member may result in extra charges due to automatic seat addition.<<DEPRECATED use create_team>>
Get time entries within a date range
This api endpoint retrieves time entries for the past 30 days for the user or others using the assignee parameter, and allows filtering by space id or task id. negative durations show active timers.
Remove tag from task
Remove a tag from a task. this does not delete the tag from the space.
Update task
Update a task by including one or more fields in the request body.
Get list members
View the people who have access to a list.<<DEPRECATED use get_list_members>>
Get teams
This endpoint allows viewing user groups (teams) in a workspace, where team id is the workspace id, and group id is a user group id in api documentation.
Get space views
View the task and page views available for a space.<<DEPRECATED use get_space_views>>
Remove guest from list
Revoke a guest’s access to a list. note: this endpoint is only available to workspaces on our enterprise plan.
Get user
View information about a user in a workspace. note: this endpoint is only available to workspaces on our enterprise plan.
Get workspace everything level views
View the task and page views available at the everything level of a workspace.<<DEPRECATED use get_workspace_everything_level_views>>
Update list
Rename a list, update the list info description, set a due date/time, set the list’s priority, set an assignee, set or remove the list color.
Remove tags from time entries
Remove labels from time entries. this does not remove the label from a workspace.
Update webhook
Update a webhook to change the events to be monitored.
Remove guest from task
Revoke a guest’s access to a task. note: this endpoint is only available to workspaces on our enterprise plan.
Get webhooks
View the webhooks created via the api for a workspace. this endpoint returns webhooks created by the authenticated user.
Remove guest from workspace
Revoke a guest’s access to a workspace. note: this endpoint is only available to workspaces on our enterprise plan.
Get workspace everything level views
View the task and page views available at the everything level of a workspace.
Get workspace plan
View the current plan for the specified workspace.
Update view
Rename a view, update the grouping, sorting, filters, columns, and settings of a view.
Update space
Rename, set the space color, and enable clickapps for a space.
Update team
The endpoint controls user group assignments in a workspace, requiring ‘team id’ and ‘group id’. adding a view-only guest as a paid member incurs prorated charges for additional seats.