Clickup

Adds a 'waiting on' or 'blocking' dependency to a task, requiring either `depends on` (task becomes waiting on) or `dependency of` (task becomes blocking), but not both; `team id` is required if `custom task ids` is true.

Adds a guest to a folder with specified permissions; requires a clickup enterprise plan.

Shares a clickup list with an existing guest user, granting them specified permissions; requires the workspace to be on the clickup enterprise plan.

Assigns a guest to a task with specified permissions; requires clickup enterprise plan, and `team id` if `custom task ids` is true.

Associates a list of specified tags with one or more time entries within a given team (workspace).

Adds an existing tag to a specified task; team id is required if custom task ids is true.

Links two existing and accessible clickup tasks, identified by `task id` (source) and `links to` (target).

Adds an existing task to an additional clickup list; the "tasks in multiple lists" clickapp must be enabled in the workspace for this.

Deprecated: use `create task attachment` to upload a file to a task; requires `multipart/form-data`.

Deprecated: use `get access token` instead. exchanges a clickup oauth 2.0 authorization code for an access token.

Deprecated: use `get authorized teams workspaces` instead to retrieve workspaces (teams) accessible to the authenticated user.

Deprecated: use `get authorized user` instead. retrieves details of the authenticated user's clickup account.

Updates the name, background color, and/or foreground color for an existing time entry tag, identified by its current `name` and `team id`.

Creates a new time entry for a specified team.

Posts a new comment to a specified clickup chat view; the 'view id' must correspond to an existing and accessible chat view.

Creates a new checklist with a specified name within an existing task, which can be identified by its standard id or a custom task id (if `custom task ids` is true, `team id` is also required).

Creates a new checklist item within a specified, existing checklist, optionally setting the item's name and assigning it to a user.

Creates a new clickup folder within the specified space, which must exist and be accessible.

Creates a new folderless list (a list not part of any folder) directly within a specified clickup space.

Creates a new, highly customizable view within a specific clickup folder using its `folder id`.

Creates a new goal in a clickup team (workspace).

Creates a new key result (target) for a specified goal in clickup to define and track measurable objectives towards achieving that goal.

Creates a new list in clickup within a specified, existing folder.

Adds a new comment with specific text to an existing and accessible clickup list, assigns it to a user, and sets notification preferences for all list members.

Creates a new, customizable view (e.g., list, board, calendar) within a specified clickup list, requiring an existing list id accessible by the user.

Creates a new space in a clickup team, with customizable name, privacy, color, and feature settings.

Creates a new tag (name, foreground color, background color) in an existing clickup space.

Creates a customizable view (e.g., list, board, gantt) within a specified clickup space, allowing configuration of grouping, sorting, filtering, and display settings.

Creates a new clickup task in a specific list, optionally as a subtask if a `parent` task id (which cannot be a subtask itself and must be in the same list) is provided.

Uploads a file as an attachment to a specified clickup task, requiring `multipart/form-data` for file upload.

Adds a comment to a clickup task; `team id` is required if `custom task ids` is true.

Creates a new task in a specified clickup list from a task template, using the provided name for the new task.

Creates a new team (user group) with specified members in a workspace; member ids must be for existing users, and be aware that adding view-only guests as paid members may incur extra charges.

Creates a clickup webhook for a team (workspace) to notify a public url on specified events (at least one, or '*' for all), optionally scoped to a space, folder, list, or task; the endpoint must accept requests from dynamic ips.

Creates a new, customizable view (e.g., list, board) at the 'everything' level for a specified team (workspace id), encompassing all tasks within that workspace.

Deletes an existing time entry, specified by `timer id`, from a workspace identified by `team id`.

Permanently deletes an existing checklist identified by its `checklist id`.

Permanently deletes an existing item, identified by `checklist item id`, from an existing checklist, identified by `checklist id`.

Deletes an existing comment from a task using its `comment id`.

Removes two dependency links for `task id`: one where `task id` is blocked by `depends on`, and another where `dependency of` is blocked by `task id`; `team id` is required if `custom task ids` is true.

Permanently and irreversibly deletes a specified folder and all its contents (lists, tasks) if the folder id exists.

Permanently removes an existing goal, identified by its `goal id`, from the workspace.

Deletes an existing key result, also referred to as a target within a goal, identified by its `key result id`.

Permanently deletes an existing list and all its contents; this action is destructive and irreversible via the api.

Permanently deletes a specified space in clickup; this action is irreversible as the space cannot be recovered via the api.

Deletes a tag from a space, identified by `tag name` in path; precise matching of tag details in the request body (`tag name 1`, `tag tag fg`, `tag tag bg`) is generally required for successful deletion.

Permanently deletes a task, using its standard id or a custom task id (requires `custom task ids=true` and `team id`).

Deletes an existing link, effectively a dependency or relationship, between two clickup tasks; set `custom task ids=true` and provide `team id` if using custom task ids.

Permanently deletes an existing team (user group) from the workspace using its `group id`.

Deletes a time-tracked interval from a task; use this legacy endpoint for older time tracking systems.

Permanently and irreversibly deletes an existing view in clickup, identified by its `view id`.

Permanently removes an existing webhook, specified by its id, thereby ceasing all its event monitoring and notifications.

Updates an existing checklist's name or position, identified by its `checklist id`.

Updates an existing checklist item, allowing modification of its name, assignee, resolution status, or parent item for nesting.

Modifies the details and permissions of an existing guest user within a specific workspace.

Updates an existing key result's progress or note in clickup, where the key result measures progress towards a goal.

Updates an existing tag's name and colors in a clickup space; requires current tag name for identification, and new values for tag name, foreground color, and background color, all of which are mandatory for the update.

Edits a legacy time-tracked interval for a task (identified by `task id` and `interval id`) to update its start/end times and duration; `team id` is required if `custom task ids` is true.

Updates a user's username, admin status, or custom role in a workspace; requires the workspace to be on an enterprise plan.

Deprecated: creates a new folder in a clickup space; use `create folder` instead.

Deprecated: use `get folders`. retrieves folders within a specified clickup space, ensuring `space id` is valid, with an option to filter by archived status.

Deprecated: retrieves detailed information about a specific folder in clickup; use `get folder` instead.

Retrieves all accessible custom field definitions for a specified clickup list using its `list id`.

Exchanges a clickup oauth 2.0 authorization code (obtained after user consent) for an access token.

Retrieves all unique tags applied to time entries within a specified clickup team (workspace).

Retrieves a list of workspaces (teams) the authenticated user can access.

Retrieves the details of the currently authenticated clickup user.

Retrieves the time spent in each status for multiple tasks; requires the 'total time in status' clickapp to be enabled in the workspace.

Retrieves comments from a specified chat view in clickup, supporting pagination via `start` and `start id` to fetch comments older than the default 25 most recent.

Retrieves all custom roles, which allow granular permission configurations, for a specified workspace (team).

Retrieves all custom task types available within a specified workspace (team id).

Retrieves a paginated list of tasks (up to 100 per page) from a specified team (workspace id in `team id`) based on various filter criteria, respecting user access permissions.

Retrieves detailed information about a specific folder in clickup.

Retrieves all lists within a specified space that are not located in any folder.

Retrieves folders within a specified clickup space, ensuring `space id` is valid, with an option to filter by archived status.

Retrieves all configured views (like list, board, calendar) for a specified, existing folder in clickup.

Retrieves detailed information for an existing clickup goal, specified by its unique `goal id`.

Retrieves goals for a specified clickup workspace (team); the `team id` must be valid and accessible.

Call this to retrieve detailed information for a specific guest within a team (workspace), ensuring the `guest id` is valid for the given `team id`; this action requires the clickup enterprise plan.

Retrieves detailed information for an existing list in clickup, identified by its unique `list id`.

Retrieves all lists within a specified, existing clickup folder, optionally filtering by archived status.

Retrieves comments for a specific clickup list, supporting pagination using `start` (timestamp) and `start id` (comment id) to fetch earlier comments; omits them for the latest 25.

Retrieves all members of a specific, existing clickup list by its id.

Retrieves all task and page views for a specified and accessible clickup list.

Retrieves the currently active time entry for a user in a workspace; a negative 'duration' in its data indicates it's running, and the response may be empty if no entry is active.

Fetches a specific time entry by its id for a given team; a negative duration in the response indicates an active timer.

Retrieves detailed information for an existing space in a clickup workspace, identified by its unique space id.

Retrieves spaces for a team id; member information for private spaces is returned only if the authenticated user is a member.

Retrieves all tags for tasks within a specified clickup space, requiring a valid `space id`.

Retrieves all task and page views for a specified space id in clickup.

Retrieves comprehensive details for a clickup task by its id, supporting standard or custom task ids (requires `team id` for custom ids).

Retrieves tasks from a specified clickup list; only tasks whose home is the given list id are returned.

Retrieves up to 25 comments for a specified task, supporting pagination using `start` and `start id` to fetch older comments.

Retrieves users with explicit access (directly assigned or shared) to a specific existing task, excluding users with inherited permissions.

Retrieves the duration a task has spent in each status, provided the 'total time in status' clickapp is enabled for the workspace.

Retrieves task templates for a specified workspace (team id), supporting pagination.

Retrieves user groups (teams) from a clickup workspace, typically requiring `team id` (workspace id), with an option to filter by `group ids`.

Retrieves time entries for a specified team (workspace id) within a date range (defaults to the last 30 days for the authenticated user if dates are omitted); active timers are indicated by negative durations in the response.

Retrieves the modification history for an existing time entry within a specific clickup team (workspace).

Retrieves tracked time for a task using a legacy endpoint; prefer newer time tracking api endpoints for managing time entries.

Retrieves detailed information for a specific user within a clickup workspace (team), available only for workspaces on the clickup enterprise plan.

Fetches details for a specific clickup view, identified by its `view id`, which must exist.

Retrieves all tasks visible in a specified clickup view, respecting its applied filters, sorting, and grouping.

Fetches webhooks for a team (workspace), returning only those created by the authenticated user via api, for a `team id` they can access.

Retrieves all task and page views at the 'everything level' (a comprehensive overview of all tasks across all spaces) for a specified clickup workspace.

Retrieves the details of the current subscription plan for a specified clickup workspace.

Retrieves seat utilization (used, total, available for members/guests) for a clickup workspace (team) id, which must be for an existing workspace.

Invites a guest by email to a clickup workspace (team) on an enterprise plan, setting initial permissions and optionally a custom role; further access configuration for specific items may require separate actions.

Invites a user via email to a clickup workspace (team), optionally granting admin rights or a custom role; requires an enterprise plan for the workspace.

Deprecated: use `get lists` instead. retrieves lists from a specified, existing clickup folder.

Deprecated: retrieves users with access to a specific list; use `get list members` instead.

Removes an existing value from a custom field on a specific task; this does not delete the custom field definition or its predefined options.

Revokes a guest's access to a specific clickup folder, optionally unsharing items explicitly shared with them within it; requires an enterprise plan.

Revokes a guest's access to a specific list, provided the guest currently has access to this list and the workspace is on the clickup enterprise plan.

Revokes a guest's access to a specific task; only available for workspaces on the clickup enterprise plan.

Permanently removes a guest from a specified workspace, revoking all their access; this destructive operation requires the workspace to be on the clickup enterprise plan.

Removes tags from specified time entries in a team, without deleting the tags from the workspace.

Removes a tag from a specified task by disassociating it (does not delete the tag from workspace), succeeding even if the tag is not on the task.

Removes a task from an extra list (not its home list); the 'tasks in multiple lists' clickapp must be enabled.

Deactivates a user from a specified clickup workspace, revoking their access (user can be reactivated later); requires the workspace to be on an enterprise plan.

Sets or updates a custom field's value for a task; the new value (with type-dependent structure, e.g., `{"value": "text"}` or `{"value": 123, "value options": {"currency type":"usd"}}`) is provided in the json request body.