Clickup

clickup Teams API

Operations for retrieving Workspace (team) information and membership.

GitHub OpenAPI

Operations 3

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 /team List Workspaces I can access · Get authorized teams (workspaces) #
Ask an LLM
“Which ClickUp Workspaces does my token have access to?”
“Does the team listing include members and their roles?”
Tell an agent
List the Workspaces I'm authorized for, with their members and roles.
Show each team I belong to with its color and avatar.
GET /team/{team_id}/seats Check seat usage in a Workspace · Get workspace seats #
Ask an LLM
“How many seats are filled versus empty in my Workspace?”
“Can I check the total seat count before inviting more people?”
Tell an agent
Show seat allocation for Workspace {team_id}.
Report filled and empty seats in team {team_id}.
GET /team/{team_id}/user List members of a Workspace · Get team members #
Ask an LLM
“Who are the members of my Workspace and what permissions do they have?”
“Is the member list only available to owners and admins?”
Tell an agent
List the members of Workspace {team_id} with their roles.
Show who belongs to team {team_id}.

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-teams-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-teams-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-teams-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: ClickUp (Workspaces) Teams API
  description: The ClickUp Teams API provides access to Workspace-level information and membership. In the ClickUp API, Teams correspond to Workspaces, which are the top-level organizational unit. The API allows developers to retrieve a list of Workspaces the authenticated user belongs to, along with member details and roles. This is typically the starting point for navigating the ClickUp hierarchy.
  version: '2.0'
  contact:
    name: ClickUp Support
    url: https://help.clickup.com
  termsOfService: https://clickup.com/terms
servers:
- url: https://api.clickup.com/api/v2
  description: ClickUp API v2 Production Server
security:
- bearerAuth: []
tags:
- name: Teams
  description: Operations for retrieving Workspace (team) information and membership.
paths:
  /team:
    get:
      operationId: getTeams
      summary: Get authorized teams (workspaces)
      description: Retrieves the Workspaces (teams) that the authenticated user has access to. Returns Workspace details including name, color, avatar, and a list of members with their roles and permissions.
      tags:
      - Teams
      responses:
        '200':
          description: Successfully retrieved teams
          content:
            application/json:
              schema:
                type: object
                properties:
                  teams:
                    type: array
                    items:
                      $ref: '#/components/schemas/Team'
        '401':
          description: Unauthorized
  /team/{team_id}/seats:
    get:
      operationId: getTeamSeats
      summary: Get workspace seats
      description: Retrieves the seat allocation information for a Workspace, including the total number of seats, filled seats, and empty seats.
      tags:
      - Teams
      parameters:
      - $ref: '#/components/parameters/teamId'
      responses:
        '200':
          description: Successfully retrieved seat information
          content:
            application/json:
              schema:
                type: object
                properties:
                  members:
                    type: object
                    properties:
                      filled_member_seats:
                        type: integer
                        description: Number of filled member seats.
                      empty_member_seats:
                        type: integer
                        description: Number of empty member seats.
                      total_member_seats:
                        type: integer
                        description: Total number of member seats.
                  guests:
                    type: object
                    properties:
                      filled_guest_seats:
                        type: integer
                        description: Number of filled guest seats.
                      empty_guest_seats:
                        type: integer
                        description: Number of empty guest seats.
                      total_guest_seats:
                        type: integer
                        description: Total number of guest seats.
        '401':
          description: Unauthorized
        '404':
          description: Team not found
  /team/{team_id}/user:
    get:
      operationId: getTeamMembers
      summary: Get team members
      description: Retrieves the members of a Workspace, including their roles and permissions. Only available to Workspace owners and admins.
      tags:
      - Teams
      parameters:
      - $ref: '#/components/parameters/teamId'
      responses:
        '200':
          description: Successfully retrieved team members
          content:
            application/json:
              schema:
                type: object
                properties:
                  members:
                    type: array
                    items:
                      $ref: '#/components/schemas/TeamMember'
        '401':
          description: Unauthorized
        '404':
          description: Team not found
components:
  schemas:
    TeamMember:
      type: object
      description: A member of a ClickUp Workspace.
      properties:
        user:
          type: object
          properties:
            id:
              type: integer
              description: The user ID.
            username:
              type: string
              description: The username.
            email:
              type: string
              format: email
              description: The email address.
            color:
              type: string
              description: The user color.
            profilePicture:
              type: string
              format: uri
              nullable: true
              description: URL of the profile picture.
            initials:
              type: string
              description: The user initials.
            role:
              type: integer
              description: The role code. 1 is owner, 2 is admin, 3 is member, 4 is guest.
            last_active:
              type: string
              description: Unix timestamp of last activity.
            date_joined:
              type: string
              description: Unix timestamp when the user joined.
            date_invited:
              type: string
              description: Unix timestamp when the user was invited.
          description: The user details.
        invited_by:
          type: object
          nullable: true
          properties:
            id:
              type: integer
              description: The inviter user ID.
            username:
              type: string
              description: The inviter username.
            email:
              type: string
              format: email
              description: The inviter email.
            color:
              type: string
              description: The inviter color.
            profilePicture:
              type: string
              format: uri
              nullable: true
              description: URL of the inviter profile picture.
            initials:
              type: string
              description: The inviter initials.
          description: The user who invited this member.
    Team:
      type: object
      description: A Workspace (team) object in ClickUp.
      properties:
        id:
          type: string
          description: The unique identifier of the Workspace.
        name:
          type: string
          description: The name of the Workspace.
        color:
          type: string
          description: The hex color code of the Workspace.
        avatar:
          type: string
          nullable: true
          description: The avatar URL of the Workspace.
        members:
          type: array
          items:
            $ref: '#/components/schemas/TeamMember'
          description: Members of the Workspace.
  parameters:
    teamId:
      name: team_id
      in: path
      required: true
      description: The unique identifier of the Workspace (team).
      schema:
        type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: ClickUp personal API token or OAuth access token.
externalDocs:
  description: ClickUp Teams API Documentation
  url: https://developer.clickup.com/reference/get-teams