Clickup

Clickup Guests API

The Guests API from Clickup — 5 operation(s) for guests.

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

POST /v2/team/{team_id}/guest Invite a guest to a Workspace · Invite Guest To Workspace #
Ask an LLM
“How do I invite an outside contractor into my ClickUp Workspace as a guest?”
“Can I stop a guest from seeing time spent or creating views when I invite them?”
Tell an agent
Invite {email} as a guest to Workspace {team_id}.
Invite guest {email} to {team_id} with custom role {custom_role_id} and tag editing set to {can_edit_tags}.
GET /v2/team/{team_id}/guest/{guest_id} Look up a guest · Get Guest #
Ask an LLM
“What permissions does a particular guest have in my Workspace?”
“Is guest lookup limited to the Enterprise Plan?”
Tell an agent
Show guest {guest_id} in Workspace {team_id}.
Get the details for guest {guest_id} of {team_id}.
PUT /v2/team/{team_id}/guest/{guest_id} Change a guest's permissions · Edit Guest On Workspace #
Ask an LLM
“Can I let an existing guest see time estimates without making them a member?”
“Is it possible to change a guest's custom role after they've joined?”
Tell an agent
Let guest {guest_id} in {team_id} see time spent: {can_see_time_spent}.
Switch guest {guest_id} in Workspace {team_id} to custom role {custom_role_id}.
DELETE /v2/team/{team_id}/guest/{guest_id} Revoke a guest's Workspace access · Remove Guest From Workspace #
Ask an LLM
“How do I kick a guest out of my Workspace entirely?”
“Can I revoke all of a contractor's guest access in one step?”
Tell an agent destructive · confirm first
Remove guest {guest_id} from Workspace {team_id}.
Revoke all Workspace access for guest {guest_id} in {team_id}.
POST /v2/task/{task_id}/guest/{guest_id} Share a task with a guest · Add Guest To Task #
Ask an LLM
“Can I share a single task with a guest and choose whether they can edit it?”
“What permission levels can a guest get on a task?”
Tell an agent
Share task {task_id} with guest {guest_id} at permission level {permission_level}.
Give guest {guest_id} read access to task {task_id}.
DELETE /v2/task/{task_id}/guest/{guest_id} Unshare a task from a guest · Remove Guest From Task #
Ask an LLM
“How do I take away a guest's access to one task?”
“Can I revoke a task share using a custom task ID?”
Tell an agent destructive · confirm first
Revoke guest {guest_id}'s access to task {task_id}.
Stop sharing task {task_id} with guest {guest_id}.
POST /v2/list/{list_id}/guest/{guest_id} Share a List with a guest · Add Guest To List #
Ask an LLM
“Can a guest be given access to a whole List at once?”
“Which permission level should I pick when sharing a List with a client?”
Tell an agent
Share List {list_id} with guest {guest_id} at permission level {permission_level}.
Give guest {guest_id} edit rights on List {list_id}.
DELETE /v2/list/{list_id}/guest/{guest_id} Unshare a List from a guest · Remove Guest From List #
Ask an LLM
“How do I remove a guest from a List they were shared on?”
“Does revoking List access leave the guest in the Workspace?”
Tell an agent destructive · confirm first
Revoke guest {guest_id}'s access to List {list_id}.
Stop sharing List {list_id} with guest {guest_id}.
POST /v2/folder/{folder_id}/guest/{guest_id} Share a Folder with a guest · Add Guest To Folder #
Ask an LLM
“Can I share an entire Folder with a guest?”
“What access levels are available when a guest is added to a Folder?”
Tell an agent
Share Folder {folder_id} with guest {guest_id} at permission level {permission_level}.
Give guest {guest_id} comment access to Folder {folder_id}.
DELETE /v2/folder/{folder_id}/guest/{guest_id} Unshare a Folder from a guest · Remove Guest From Folder #
Ask an LLM
“How do I pull a guest's access to a Folder?”
“Is removing a guest from a Folder an Enterprise-only feature?”
Tell an agent destructive · confirm first
Revoke guest {guest_id}'s access to Folder {folder_id}.
Stop sharing Folder {folder_id} with guest {guest_id}.

Documentation

📖
APIReference
https://developer.clickup.com/reference
📖
Documentation
https://developer.clickup.com/docs

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/clickup/refs/heads/main/openapi/clickup-guests-api-openapi.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-guests-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-guests-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: ClickUp API v2 Reference Guests API
  description: The ClickUp API enables you to programmatically access and manage your ClickUp resources.
  contact: {}
  version: '2.0'
servers:
- url: https://api.clickup.com/api
  description: ClickUp
  variables: {}
security:
- Authorization_Token: []
tags:


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