API Coverage

May 29, 2026 · View on GitHub

Status: :white_check_mark: implemented | :construction: planned | :no_entry_sign: won't add

Tasks

Feature	Command	Status
List my tasks	`cup tasks`	:white_check_mark:
Get task details	`cup task <id>`	:white_check_mark:
Create task	`cup create`	:white_check_mark:
Update task	`cup update <id>`	:white_check_mark:
Delete task	`cup delete <id>`	:white_check_mark:
Search tasks	`cup search <query>`	:white_check_mark:
Open in browser	`cup open <query>`	:white_check_mark:
List subtasks	`cup subtasks <id>`	:white_check_mark:
Assign / unassign	`cup assign <id>`	:white_check_mark:
Group assignees	`cup assign --group`, `cup update --group-assignee`, `cup create --group-assignee`	:white_check_mark:
Duplicate task	`cup duplicate <id>`	:white_check_mark:
Create from template	`cup create --template`	:white_check_mark:
Task members	`cup task-members <taskId>`	:white_check_mark:
Merge task	`cup merge <source> <into>`	:white_check_mark:
Bulk operations	`cup bulk <status\|assign\|due-date\|tag\|priority\|field\|move>`	:white_check_mark:

Dependencies & Relations

Feature	Command	Status
Add dependency	`cup depend <id>`	:white_check_mark:
Remove dependency	`cup depend <id> --remove`	:white_check_mark:
Add/remove task link	`cup link <id> <linksTo>`	:white_check_mark:

Multi-list

Feature	Command	Status
Add task to list	`cup move <id> --to`	:white_check_mark:
Remove from list	`cup move <id> --remove`	:white_check_mark:
Move to home list	`cup move --to ... --remove ...`	:white_check_mark:

Sprints & Planning

Feature	Command	Status
Active sprint tasks	`cup sprint [--folder]`	:white_check_mark:
List all sprints	`cup sprints`	:white_check_mark:
Assigned tasks by status	`cup assigned`	:white_check_mark:
Standup summary	`cup summary`	:white_check_mark:
Overdue tasks	`cup overdue`	:white_check_mark:
Recently updated	`cup inbox`	:white_check_mark:

Comments

Feature	Command	Status
List comments	`cup comments <id>`	:white_check_mark:
Post comment	`cup comment <id>`	:white_check_mark:
Edit comment	`cup comment-edit <id>`	:white_check_mark:
Task + comments combined	`cup activity <id>`	:white_check_mark:
Delete comment	`cup comment-delete <id>`	:white_check_mark:
Threaded replies	`cup replies <id>` / `cup reply <id>`	:white_check_mark:
List comments (list)	`cup list-comments <listId>`	:white_check_mark:
Post comment (list)	`cup list-comment <listId>`	:white_check_mark:
List comments (view)	`cup view-comments <viewId>`	:white_check_mark:
Post comment (view)	`cup view-comment <viewId>`	:white_check_mark:

Checklists

Feature	Command	Status
View checklists	`cup checklist view <id>`	:white_check_mark:
Create checklist	`cup checklist create <id> <name>`	:white_check_mark:
Delete checklist	`cup checklist delete <id>`	:white_check_mark:
Add item	`cup checklist add-item <id> <name>`	:white_check_mark:
Edit item	`cup checklist edit-item <id> <itemId>`	:white_check_mark:
Delete item	`cup checklist delete-item <id> <itemId>`	:white_check_mark:

Custom Fields

Feature	Command	Status
Set field value	`cup field <id> --set`	:white_check_mark:
Remove field value	`cup field <id> --remove`	:white_check_mark:
List available fields	`cup fields <listId>`	:white_check_mark:
Create custom field	`cup field-create <name>`	:white_check_mark:

Feature	Command	Status
Add/remove tag on task	`cup tag <id>`	:white_check_mark:
List space tags	`cup tags <spaceId>`	:white_check_mark:
Create space tag	`cup tag-create <spaceId> <name>`	:white_check_mark:
Update space tag	`cup tag-update <spaceId> <name>`	:white_check_mark:
Delete space tag	`cup tag-delete <spaceId> <name>`	:white_check_mark:

Time Tracking

Feature	Command	Status
Start timer	`cup time start <id>`	:white_check_mark:
Stop timer	`cup time stop`	:white_check_mark:
Timer status	`cup time status`	:white_check_mark:
Log time entry	`cup time log <id> <duration>`	:white_check_mark:
List entries	`cup time list`	:white_check_mark:
Update entry	`cup time update <id>`	:white_check_mark:
Delete entry	`cup time delete <id>`	:white_check_mark:
Per-user estimate	`cup time estimate-by-user <id> <userId> <dur>`	:white_check_mark:

Workspace

Feature	Command	Status
List spaces	`cup spaces`	:white_check_mark:
Create space	`cup space-create <name>`	:white_check_mark:
Rename space	`cup space-rename <spaceId> <n>`	:white_check_mark:
Delete space	`cup space-delete <spaceId>`	:white_check_mark:
List lists	`cup lists <spaceId>`	:white_check_mark:
Create list	`cup list-create <spaceId> <name>`	:white_check_mark:
Rename list	`cup list-rename <listId> <n>`	:white_check_mark:
Delete list	`cup list-delete <listId>`	:white_check_mark:
List folders	`cup folders <spaceId>`	:white_check_mark:
Create folder	`cup folder-create <spaceId> <n>`	:white_check_mark:
Rename folder	`cup folder-rename <folderId> <n>`	:white_check_mark:
Delete folder	`cup folder-delete <folderId>`	:white_check_mark:
Shared hierarchy	`cup shared`	:white_check_mark:
Check auth	`cup auth`	:white_check_mark:
Workspace plan	`cup plan`	:white_check_mark:
List members	`cup members`	:white_check_mark:
List user groups	`cup groups`	:white_check_mark:
Task types	`cup task-types`	:white_check_mark:
Task templates	`cup templates`	:white_check_mark:
List templates	`cup list-templates`	:white_check_mark:
Folder tmpl.	`cup folder-templates`	:white_check_mark:
Create from tpl	`cup list-from-template <name>`	:white_check_mark:

Views

Feature	Command	Status
List views	`cup views <listId>`	:white_check_mark:
Get view	`cup view <viewId>`	:white_check_mark:
Create view	`cup view-create <listId> <name>`	:white_check_mark:
Update view	`cup view-update <viewId>`	:white_check_mark:
Delete view	`cup view-delete <viewId>`	:white_check_mark:

Goals & Key Results

Feature	Command	Status
List goals	`cup goals`	:white_check_mark:
Create goal	`cup goal-create <name>`	:white_check_mark:
Update goal	`cup goal-update <goalId>`	:white_check_mark:
Delete goal	`cup goal-delete <goalId>`	:white_check_mark:
List key results	`cup key-results <goalId>`	:white_check_mark:
Create key result	`cup key-result-create <goalId> <n>`	:white_check_mark:
Update key result	`cup key-result-update <krId>`	:white_check_mark:
Delete key result	`cup key-result-delete <krId>`	:white_check_mark:

Docs

Feature	Command	Status
Search docs	`cup docs [query]`	:white_check_mark:
View doc / page	`cup doc <docId> [pageId]`	:white_check_mark:
All page content	`cup doc-pages <docId>`	:white_check_mark:
Create doc	`cup doc-create <title>`	:white_check_mark:
Create page	`cup doc-page-create <docId> <name>`	:white_check_mark:
Edit page	`cup doc-page-edit <docId> <pageId>`	:white_check_mark:
Delete doc	`cup doc-delete <docId>`	:white_check_mark:
Delete page	`cup doc-page-delete <docId> <pId>`	:white_check_mark:

Attachments

Feature	Command	Status
Upload file	`cup attach <id> <file>`	:white_check_mark:
List attachments	`cup attachments <taskId>`	:white_check_mark:
Delete attachment		:no_entry_sign: No API endpoint

Setup

Feature	Command	Status
First-time setup	`cup init`	:white_check_mark:
Get/set config	`cup config`	:white_check_mark:
Shell completions	`cup completion <shell>`	:white_check_mark:

Chat

Feature	Command	Status
List channels	`cup chat channels`	:white_check_mark:
Get channel	`cup chat channel <id>`	:white_check_mark:
Create channel	`cup chat channel-create <name>`	:white_check_mark:
Create DM	`cup chat dm <userIds...>`	:white_check_mark:
Create location ch.	`cup chat channel-create --space/--folder/--list`	:white_check_mark:
Update channel	`cup chat channel-update <id>`	:white_check_mark:
Delete channel	`cup chat channel-delete <id>`	:white_check_mark:
List members	`cup chat members <id>`	:white_check_mark:
List followers	`cup chat followers <id>`	:white_check_mark:
List messages	`cup chat messages <channelId>`	:white_check_mark:
Send message	`cup chat send <channelId>`	:white_check_mark:
Update message	`cup chat message-update <id>`	:white_check_mark:
Delete message	`cup chat message-delete <id>`	:white_check_mark:
List replies	`cup chat replies <messageId>`	:white_check_mark:
Send reply	`cup chat reply <messageId>`	:white_check_mark:
List reactions	`cup chat reactions <messageId>`	:white_check_mark:
Add reaction	`cup chat react <messageId>`	:white_check_mark:
Remove reaction	`cup chat unreact <messageId>`	:white_check_mark:

Webhooks

Feature	Command	Status
List webhooks	`cup webhook list`	:white_check_mark:
Create webhook	`cup webhook create`	:white_check_mark:
Update webhook	`cup webhook update <id>`	:white_check_mark:
Delete webhook	`cup webhook delete <id>`	:white_check_mark:

Won't add

Feature	Why
OAuth flow	`cup init` already handles auth with API tokens.
Guest/ACL	Enterprise admin. Not what you reach for in a terminal.
Chat tagged users	Low value for CLI. Returns who was @mentioned in a message.
Audit logs	Enterprise admin.
User/group management	Too destructive for a CLI - removing someone from a workspace is permanent.
List/Folder/Space U	Updating structural item settings (beyond rename) belongs in the UI.

API Limitations

These features exist in the ClickUp UI but aren't possible through the API:

Feature	Limitation
Comment attachments	API only supports task-level attachments (`cup attach`), not files within comments
@mention individual users	API provides `--notify-all` but no way to target specific users via @syntax
Comment reactions	No API endpoint for adding or viewing reactions
ClickUp Brain / AI	No public API
In-comment checklists	Only task-level checklists are supported via API
Voice notes / Video	Recording is a UI-only feature