Clickup

clickup Spaces API

Operations for managing Spaces within a ClickUp Workspace.

GitHub OpenAPI

Operations 10

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}/space List the Spaces in a Workspace (v2) · Get Spaces #
Ask an LLM
“What Spaces are in my Workspace, via the v2 endpoint?”
“Can I include archived Spaces in the v2 Spaces listing?”
Tell an agent
Via v2, list Spaces in Workspace {team_id}.
Using v2, list Spaces in Workspace {team_id} with archived set to {archived}.
POST /v2/team/{team_id}/space Create a Space (v2) · Create Space #
Ask an LLM
“How do I add a new Space to a Workspace through v2?”
“Which settings are required when creating a Space with v2?”
Tell an agent
Via v2, create Space {name} in Workspace {team_id} with multiple assignees {multiple_assignees} and features {features}.
Using v2, add a Space named {name} to Workspace {team_id}.
GET /v2/space/{space_id} Get a Space's details (v2) · Get Space #
Ask an LLM
“How do I look up a single Space via v2?”
“Can I fetch one Space by its ID with the v2 endpoint?”
Tell an agent
Via v2, get Space {space_id}.
Using v2, show the details of Space {space_id}.
PUT /v2/space/{space_id} Update a Space's settings (v2) · Update Space #
Ask an LLM
“How do I rename a Space or set its color via v2?”
“Can I turn ClickApps on for a Space with the v2 update?”
Tell an agent
Via v2, make Space {space_id} private {private} and set its enabled ClickApps to {features}.
Using v2, rename Space {space_id} to {name}.
DELETE /v2/space/{space_id} Delete a Space (v2) · Delete Space #
Ask an LLM
“What's the v2 endpoint for removing a Space from my Workspace?”
“Can I delete a Space by ID via v2?”
Tell an agent destructive · confirm first
Via v2, delete Space {space_id}.
Using v2, remove Space {space_id} from the Workspace.
GET /team/{team_id}/space List Spaces (unversioned path) · Get spaces #
Ask an LLM
“Which non-v2 endpoint lists all Spaces in a Workspace?”
“Can I get archived Spaces from the unversioned path?”
Tell an agent
Using the unversioned path, list Spaces in Workspace {team_id}.
On the non-v2 endpoint, show Spaces in Workspace {team_id} including archived ones.
POST /team/{team_id}/space Create a Space (unversioned path) · Create a space #
Ask an LLM
“Is there a non-v2 path to create a Space with just a name?”
“Can I configure a new Space's features on the unversioned endpoint?”
Tell an agent
Using the unversioned path, create Space {name} in Workspace {team_id}.
On the non-v2 endpoint, create Space {name} in Workspace {team_id} with features {features}.
GET /space/{space_id} Get a Space's features and statuses (unversioned) · Get a space #
Ask an LLM
“Which non-v2 endpoint returns a Space's features and statuses?”
“Can I read a Space's configuration on the unversioned path?”
Tell an agent
Using the unversioned path, get Space {space_id}.
On the non-v2 endpoint, show the statuses and features of Space {space_id}.
PUT /space/{space_id} Update a Space (unversioned path) · Update a space #
Ask an LLM
“Is there a non-v2 path to make a Space private?”
“Can I change just a Space's color on the unversioned endpoint?”
Tell an agent
Using the unversioned path, set Space {space_id} private to {private}.
On the non-v2 endpoint, change Space {space_id} color to {color}.
DELETE /space/{space_id} Delete a Space and all contents (unversioned) · Delete a space #
Ask an LLM
“Does deleting a Space on the non-v2 path also remove its Folders, Lists and tasks?”
“Is Space deletion through the unversioned endpoint reversible?”
Tell an agent destructive · confirm first
Using the unversioned path, permanently delete Space {space_id} and everything in it.
On the non-v2 endpoint, remove Space {space_id} with its Folders, Lists and tasks.

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-spaces-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-spaces-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-spaces-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Clickup Spaces API
  version: '2.0'
  description: 'Operations tagged Spaces across 2 of this provider''s published API definitions: clickup-api-v2-reference-openapi.json, clickup-spaces-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 (56 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/openapi/clickup-spaces-api-openapi.yml