Clickup

clickup Goals API

Operations for managing Goals and Key Results within a ClickUp Workspace.

GitHub OpenAPI
Business capability
Strategy Execution Management BC-100.20

Operations 16

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v2/team/{team_id}/goal List the Goals in a Workspace (v2) · Get Goals #
Ask an LLM
“What Goals does my Workspace have, according to the v2 endpoint?”
“Can the v2 Goals listing include completed Goals?”
Tell an agent
Via v2, list Goals in Workspace {team_id}.
Using v2, show all Goals in Workspace {team_id} including completed ones.
POST /v2/team/{team_id}/goal Create a Goal (v2) · Create Goal #
Ask an LLM
“How do I set up a new Goal with owners and a due date through v2?”
“Which fields does the v2 create-Goal call require?”
Tell an agent
Via v2, create Goal {name} in Workspace {team_id} due {due_date}, owned by {owners}, color {color}.
Using v2, add Goal {name} to Workspace {team_id} due {due_date}.
GET /v2/goal/{goal_id} Get a Goal and its Targets (v2) · Get Goal #
Ask an LLM
“How can I see a single Goal's Targets through v2?”
“Does the v2 Goal lookup return its Targets?”
Tell an agent
Via v2, get Goal {goal_id} with its Targets.
Using v2, show details of Goal {goal_id}.
PUT /v2/goal/{goal_id} Update a Goal (v2) · Update Goal #
Ask an LLM
“How do I rename a Goal or change its due date via v2?”
“Can I add and remove Goal owners in the same v2 update?”
Tell an agent
Via v2, rename Goal {goal_id} to {name}, due {due_date}, description {description}, color {color}.
Using v2, add owners {add_owners} and remove owners {rem_owners} on Goal {goal_id}.
DELETE /v2/goal/{goal_id} Delete a Goal (v2) · Delete Goal #
Ask an LLM
“What's the v2 endpoint for removing a Goal from my Workspace?”
“Can I delete a Goal by ID via v2?”
Tell an agent destructive · confirm first
Via v2, delete Goal {goal_id}.
Using v2, remove Goal {goal_id} from the Workspace.
POST /v2/goal/{goal_id}/key_result Add a Target to a Goal (v2) · Create Key Result #
Ask an LLM
“How do I add a measurable Target to a Goal through v2?”
“Can a v2 Target track progress from specific tasks or Lists?”
Tell an agent
Via v2, add Target {name} of type {type} to Goal {goal_id}, owners {owners}, from {steps_start} to {steps_end} {unit}, tasks {task_ids}, Lists {list_ids}.
Using v2, create a {type} Target called {name} on Goal {goal_id}.
PUT /v2/key_result/{key_result_id} Update a Target's progress (v2) · Edit Key Result #
Ask an LLM
“How do I record progress on a Goal Target through v2?”
“Can I leave a note when updating a Target in v2?”
Tell an agent
Via v2, set Target {key_result_id} current progress to {steps_current} with note {note}.
Using v2, update Target {key_result_id} to {steps_current}.
DELETE /v2/key_result/{key_result_id} Delete a Target from a Goal (v2) · Delete Key Result #
Ask an LLM
“What's the v2 way to remove a Target from a Goal?”
“Can I delete a single Target without deleting its Goal via v2?”
Tell an agent destructive · confirm first
Via v2, delete Target {key_result_id}.
Using v2, remove Target {key_result_id} from its Goal.
GET /team/{team_id}/goal List Goals with progress (unversioned path) · Get goals #
Ask an LLM
“Which non-v2 endpoint lists Goals with their key results and progress?”
“Can the unversioned Goals listing include completed Goals?”
Tell an agent
Using the unversioned path, list Goals in Workspace {team_id}.
On the non-v2 endpoint, show Goal progress for Workspace {team_id}.
POST /team/{team_id}/goal Create a Goal (unversioned path) · Create a goal #
Ask an LLM
“Is there a non-v2 path to create a Goal with only a name and due date?”
“Can I set a Goal's color on the unversioned create endpoint?”
Tell an agent
Using the unversioned path, create Goal {name} in Workspace {team_id} due {due_date}.
On the non-v2 endpoint, add Goal {name} to Workspace {team_id} due {due_date} with color {color}.
GET /goal/{goal_id} Get a Goal's key results and progress (unversioned) · Get a goal #
Ask an LLM
“Which non-v2 endpoint shows one Goal's key results and progress?”
“Can I look up a Goal on the unversioned path?”
Tell an agent
Using the unversioned path, get Goal {goal_id}.
On the non-v2 endpoint, show key results and progress of Goal {goal_id}.
PUT /goal/{goal_id} Update a Goal (unversioned path) · Update a goal #
Ask an LLM
“Is there a non-v2 path for changing only a Goal's name?”
“Can I update a Goal's owners through the unversioned endpoint?”
Tell an agent
Using the unversioned path, rename Goal {goal_id} to {name}.
On the non-v2 endpoint, add owners {add_owners} to Goal {goal_id}.
DELETE /goal/{goal_id} Delete a Goal and its key results (unversioned) · Delete a goal #
Ask an LLM
“Does deleting a Goal on the non-v2 path also delete its key results?”
“Is removing a Goal through the unversioned endpoint permanent?”
Tell an agent destructive · confirm first
Using the unversioned path, permanently delete Goal {goal_id} and its key results.
On the non-v2 endpoint, remove Goal {goal_id} for good.
POST /goal/{goal_id}/key_result Create a key result on a Goal (unversioned) · Create a key result #
Ask an LLM
“Which key result types can I create on the non-v2 path, like currency or percentage?”
“Can a key result on the unversioned endpoint track task completion automatically?”
Tell an agent
Using the unversioned path, create a {type} key result named {name} on Goal {goal_id}.
On the non-v2 endpoint, add key result {name} of type {type} to Goal {goal_id} targeting {steps_end}.
PUT /key_result/{key_result_id} Edit a key result (unversioned path) · Edit a key result #
Ask an LLM
“Is there a non-v2 path to update a key result's progress?”
“Can I add a note to a key result on the unversioned endpoint?”
Tell an agent
Using the unversioned path, set key result {key_result_id} progress to {steps_current}.
On the non-v2 endpoint, add note {note} to key result {key_result_id}.
DELETE /key_result/{key_result_id} Delete a key result (unversioned path) · Delete a key result #
Ask an LLM
“Which non-v2 endpoint permanently deletes a key result?”
“Can I remove a key result through the unversioned path?”
Tell an agent destructive · confirm first
Using the unversioned path, permanently delete key result {key_result_id}.
On the non-v2 endpoint, remove key result {key_result_id} from its Goal.

Documentation

📖
Documentation
https://developer.clickup.com/docs/tasks
📖
Documentation
https://developer.clickup.com/reference/get-spaces
📖
Documentation
https://developer.clickup.com/reference/get-lists
📖
Documentation
https://developer.clickup.com/reference/get-folders
📖
Documentation
https://developer.clickup.com/reference/get-goals
📖
Documentation
https://developer.clickup.com/reference/get-task-comments
📖
Documentation
https://developer.clickup.com/reference/get-teams
📖
Documentation
https://developer.clickup.com/docs/webhooks
📖
Documentation
https://developer.clickup.com/reference/get-accessible-custom-fields
📖
Documentation
https://developer.clickup.com/reference/get-time-entries-within-a-date-range
📖
Documentation
https://developer.clickup.com/reference/get-views
📖
Documentation
https://developer.clickup.com/docs/authentication

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/openapi/clickup-goals-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/asyncapi/clickup-webhooks-asyncapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/clickup:clickup-goals-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

clickup-goals-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Clickup Goals API
  version: '2.0'
  description: 'Operations tagged Goals across 2 of this provider''s published API definitions: clickup-api-v2-reference-openapi.json, clickup-goals-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.clickup.com/api
  description: ClickUp
  variables: {}
- url: https://api.clickup.com/api/v2
  description: ClickUp API v2 Production Server
tags:


# --- truncated at 32 KB (84 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/openapi/clickup-goals-api-openapi.yml