ClickUp unifies tasks, docs, goals, and chat in a single platform, allowing teams to plan, organize, and collaborate across projects with customizable workflows
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.
Rename an time entry label.
Delete a line item from a task checklist.
Share a list with a guest. note: this endpoint is only available to workspaces on our enterprise plan.
Delete a time entry from a workspace.
View the workspaces available to the authenticated user.<<DEPRECATED use get_authorized_teams_workspaces>>
Add a list, board, calendar, table, timeline, workload, activity, map, chat, or gantt view to a folder.
Share a task with a guest. note: this endpoint is only available to workspaces on our enterprise plan.
Add a list, board, calendar, table, timeline, workload, activity, map, chat, or gantt view to a space.
View the details of the authenticated user’s clickup account.<<DEPRECATED use get_authorized_user>>
Delete a task comment.
Delete a checklist from a task.
Add a list, board, calendar, table, timeline, workload, activity, map, chat, or gantt view at the everything level of a workspace.
Create a new task.
Delete a folder from your workspace.
Delete a target from a goal.
Delete a list from your workspace.
Add a new goal to a workspace.
Remove a goal from your workspace.
Create a time entry. note: a time entry that has a negative duration means that timer is currently running for that user.
Add a new comment to a chat view.
Add a label to a time entry.
Upload a file to a task as an attachment. note: this request uses multipart/form-data as the content type.
Delete a space from your workspace.
Delete a task tag from a space.
Remove the dependency relationship between two or more tasks.
Add a new comment to a task.
Delete a task from your workspace.
Add a tag to a task.
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.
Add a target to a goal.
Set a task as waiting on or blocking another task.
Create a new task using a task template.
Add a new checklist to a task.
note: this is a legacy time tracking endpoint. we recommend using the time tracking api endpoints to manage time entries.
Delete a webhook to stop monitoring the events and locations of the webhook.
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.
Rename a task checklist, or reorder a checklist so it appears above or below other checklists on a task.
Update a target.
Add a line item to a task checklist.
Add a task to an additional list. note: this endpoint requires the tasks in multiple list clickapp to be enabled.
Share a folder with a guest. note: this endpoint is only available to workspaces on our enterprise plan.
Add a new folder to a space.<<DEPRECATED use create_folder>>
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>>
View the lists within a folder.<<DEPRECATED use get_folder>>
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.
Add a new list to a folder.
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>>
View the details of the authenticated user’s clickup account.
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.
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.
View the custom fields available on tasks in a specific list.
View the workspaces available to the authenticated user.
View the folders in a space.<<DEPRECATED use get_folders>>
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.
View all the labels that have been applied to time entries in a workspace.
View how long two or more tasks have been in each status.
View the custom task types available in a workspace.
Update a user’s name and role. note: this endpoint is only available to workspaces on our enterprise plan.
Add a comment to a list.
View the lists within a folder.
View the lists in a space that aren’t located in a folder.
Update a task tag.
View the custom roles available in a workspace.
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.
note: this is a legacy time tracking endpoint. we recommend using the time tracking api endpoints to manage time entries.
Add a new list in a space.
Rename and configure options for a guest. note: this endpoint is only available to workspaces on our enterprise plan.
Add a new space to a workspace.
Add a list, board, calendar, table, timeline, workload, activity, map, chat, or gantt view to a list.
Add a new task tag to a space.
Add a new folder to a space.
View the task tags available in a space.
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.
View information about a guest. note: this endpoint is only available to workspaces on our enterprise plan.
View the folders in a space.
View the people who have access to a list.
View the spaces avialable in a workspace. you can only get member info in private spaces.
View the task and page views available for a folder.
View the task and page views available for a list.views and required views are separate responses.
View the goals available in a workspace.
View the task templates available in a workspace.
View the spaces available in a workspace.
View information about a task. you can only view task information of tasks you can access. tasks with attachments will return an “attachments” response.
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.
View the details of a goal including its targets.
View information about a list.
View the people who have access to a task.
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.
View the used, total, and available member and guest seats for a workspace.
View information about a specific task or page view.
See all visible tasks in a view in clickup.
View a single time entry. note: a time entry that has a negative duration means that timer is currently running for that user.
note: this is a legacy time tracking endpoint. we recommend using the time tracking api endpoints to manage time entries.
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.
View a list of changes made to a time entry.
Remove the data from a custom field on a task. this does not delete the option from the custom field.
Revoke a guest’s access to a folder. note: this endpoint is only available to workspaces on our enterprise plan.
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.
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.
Deactivate a user from a workspace. note: this endpoint is only available to workspaces on our enterprise plan.
View the spaces available in a workspace.<<DEPRECATED use get_space>>
View the task and page views available for a space.
View the lists within a folder.
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.
View the spaces avialable in a workspace. you can only get member info in private spaces.<<DEPRECATED use get_spaces>>
Start a timer for the authenticated user.
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.
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>>
View the lists within a folder.<<DEPRECATED use get_lists>>
View the current plan for the specified workspace.<<DEPRECATED use get_workspace_plan>>
Stop a timer that’s currently running for the authenticated user.
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.
Add a new checklist to a task.<<DEPRECATED use create_checklist>>
View the tasks, lists, and folders that have been shared with the authenticated user.
View the used, total, and available member and guest seats for a workspace.<<DEPRECATED use get_workspace_seats>>
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>>
Rename a folder.
note: this is a legacy time tracking endpoint. we recommend using the time tracking api endpoints to manage time entries.
Rename a goal, set the due date, replace the description, add or remove owners, and set the goal color.
Replace the content of a task commment, assign a comment, and mark a comment as resolved.
Update the details of a time entry.
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>>
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 a tag from a task. this does not delete the tag from the space.
Update a task by including one or more fields in the request body.
View the people who have access to a list.<<DEPRECATED use get_list_members>>
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.
View the task and page views available for a space.<<DEPRECATED use get_space_views>>
Revoke a guest’s access to a list. note: this endpoint is only available to workspaces on our enterprise plan.
View information about a user in a workspace. note: this endpoint is only available to workspaces on our enterprise plan.
View the task and page views available at the everything level of a workspace.<<DEPRECATED use get_workspace_everything_level_views>>
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 labels from time entries. this does not remove the label from a workspace.
Update a webhook to change the events to be monitored.
Revoke a guest’s access to a task. note: this endpoint is only available to workspaces on our enterprise plan.
View the webhooks created via the api for a workspace. this endpoint returns webhooks created by the authenticated user.
Revoke a guest’s access to a workspace. note: this endpoint is only available to workspaces on our enterprise plan.
View the task and page views available at the everything level of a workspace.
View the current plan for the specified workspace.
Rename a view, update the grouping, sorting, filters, columns, and settings of a view.
Rename, set the space color, and enable clickapps for a space.
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.