Clickup
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
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
Change tag names from time entries
Rename an time entry label.
Delete checklist item
Delete checklist item
Delete a line item from a task checklist.
Add guest to list
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
Delete a time entry from a workspace.
Get authorized teams workspaces
Get authorized teams workspaces
Create folder view
Create folder view
Add a list, board, calendar, table, timeline, workload, activity, map, chat, or gantt view to a folder.
Add guest to task
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
Create space view
Add a list, board, calendar, table, timeline, workload, activity, map, chat, or gantt view to a space.
Get authorized user
Get authorized user
Delete comment
Delete comment
Delete a task comment.
Delete checklist
Delete checklist
Delete a checklist from a task.
Create workspace everything level view
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 task
Create a new task.
Delete folder
Delete folder
Delete a folder from your workspace.
Delete key result
Delete key result
Delete a target from a goal.
Delete list
Delete list
Delete a list from your workspace.
Create goal
Create goal
Add a new goal to a workspace.
Delete goal
Delete goal
Remove a goal from your workspace.
Create a time entry
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
Create chat view comment
Add a new comment to a chat view.
Add tags from time entries
Add tags from time entries
Create task attachment
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 space
Delete a space from your workspace.
Delete space tag
Delete space tag
Delete a task tag from a space.
Delete dependency
Delete dependency
Remove the dependency relationship between two or more tasks.
Create task comment
Create task comment
Add a new comment to a task.
Delete task link
Delete task link
Remove the link between two tasks.
Delete task
Delete task
Delete a task from your workspace.
Add tag to task
Add tag to task
Add a tag to a task.
Delete team
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
Create key result
Add a target to a goal.
Add dependency
Add dependency
Set a task as waiting on or blocking another task.
Create task from template
Create task from template
Create a new task using a task template.
Create checklist
Create checklist
Add a new checklist to a task.
Delete time tracked
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 webhook
Delete a webhook to stop monitoring the events and locations of the webhook.
Delete view
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
Add task link
Link two tasks together.
Edit checklist
Edit checklist
Rename a task checklist, or reorder a checklist so it appears above or below other checklists on a task.
Edit key result
Edit key result
Update a target.
Create checklist item
Create checklist item
Add a line item to a task checklist.
Add task to list
Add task to list
Add a task to an additional list. note: this endpoint requires the tasks in multiple list clickapp to be enabled.
Add guest to folder
Add guest to folder
Share a folder with a guest. note: this endpoint is only available to workspaces on our enterprise plan.
Create folder
Create folder
Add a new folder to a space.<<DEPRECATED use create_folder>>
Create task attachment
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
Get folder
View the lists within a folder.<<DEPRECATED use get_folder>>
Edit checklist item
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
Create list
Add a new list to a folder.
Get access token
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
Get authorized user
Create team
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
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
Get accessible custom fields
View the custom fields available on tasks in a specific list.
Get authorized teams workspaces
Get authorized teams workspaces
Get folders
Get folders
View the folders in a space.<<DEPRECATED use get_folders>>
Get access token
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
Get all tags from time entries
Get bulk tasks time in status
Get bulk tasks time in status
View how long two or more tasks have been in each status.
Get custom task types
Get custom task types
View the custom task types available in a workspace.
Edit user on 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
Create list comment
Add a comment to a list.
Get folder
Get folder
View the lists within a folder.
Get folderless lists
Get folderless lists
View the lists in a space that aren’t located in a folder.
Edit space tag
Edit space tag
Update a task tag.
Get custom roles
Get custom roles
View the custom roles available in a workspace.
Get filtered team tasks
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
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
Create folderless list
Add a new list in a space.
Edit guest on workspace
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
Create space
Add a new space to a workspace.
Create list view
Create list view
Add a list, board, calendar, table, timeline, workload, activity, map, chat, or gantt view to a list.
Create space tag
Create space tag
Add a new task tag to a space.
Create folder
Create folder
Add a new folder to a space.
Get space tags
Get space tags
Get task s time in status
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
Get guest
View information about a guest. note: this endpoint is only available to workspaces on our enterprise plan.
Get folders
Get folders
View the folders in a space.
Get list members
Get list members
View the people who have access to a list.
Get spaces
Get spaces
View the spaces avialable in a workspace. you can only get member info in private spaces.
Get folder views
Get folder views
View the task and page views available for a folder.
Get list views
Get list views
View the task and page views available for a list.
views and required views are separate responses.
Get goals
Get goals
View the goals available in a workspace.
Get task templates
Get task templates
View the task templates available in a workspace.
Get space
Get space
View the spaces available in a workspace.
Get task
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
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
Get goal
View the details of a goal including its targets.
Get list
Get list
View information about a list.
Get task members
Get task members
View the people who have access to a task.
Get running time entry
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
Get workspace seats
View the used, total, and available member and guest seats for a workspace.
Get view
Get view
View information about a specific task or page view.
Get view tasks
Get view tasks
See all visible tasks in a view in clickup.
Get singular time entry
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
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
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
Get time entry history
View a list of changes made to a time entry.
Remove custom field value
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
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
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
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
Remove user from workspace
Deactivate a user from a workspace. note: this endpoint is only available to workspaces on our enterprise plan.
Get space
Get space
View the spaces available in a workspace.<<DEPRECATED use get_space>>
Get space views
Get space views
View the task and page views available for a space.
Get lists
Get lists
View the lists within a folder.
Remove task from list
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
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 time entry
Start a timer for the authenticated user.
Invite user to workspace
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
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
Get lists
View the lists within a folder.<<DEPRECATED use get_lists>>
Get workspace plan
Get workspace plan
View the current plan for the specified workspace.<<DEPRECATED use get_workspace_plan>>
Stop a time entry
Stop a time entry
Stop a timer that’s currently running for the authenticated user.
Set custom field value
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
Create checklist
Add a new checklist to a task.<<DEPRECATED use create_checklist>>
Shared hierarchy
Shared hierarchy
Get workspace seats
Get workspace seats
View the used, total, and available member and guest seats for a workspace.<<DEPRECATED use get_workspace_seats>>
Get tasks
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
Update folder
Rename a folder.
Track time
Track time
note: this is a legacy time tracking endpoint. we recommend using the time tracking api endpoints to manage time entries.
Update goal
Update goal
Rename a goal, set the due date, replace the description, add or remove owners, and set the goal color.
Update comment
Update comment
Replace the content of a task commment, assign a comment, and mark a comment as resolved.
Update a time entry
Update a time entry
Update the details of a time entry.
Create team
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
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 tag from task
Remove a tag from a task. this does not delete the tag from the space.
Update task
Update task
Update a task by including one or more fields in the request body.
Get list members
Get list members
View the people who have access to a list.<<DEPRECATED use get_list_members>>
Get teams
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
Get space views
View the task and page views available for a space.<<DEPRECATED use get_space_views>>
Remove guest from list
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
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
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
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 tags from time entries
Update webhook
Update webhook
Update a webhook to change the events to be monitored.
Remove guest from task
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
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
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
Get workspace everything level views
View the task and page views available at the everything level of a workspace.
Get workspace plan
Get workspace plan
View the current plan for the specified workspace.
Update view
Update view
Rename a view, update the grouping, sorting, filters, columns, and settings of a view.
Update space
Update space
Rename, set the space color, and enable clickapps for a space.
Update team
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.