Clickup

clickup Teams API

Operations for retrieving Workspace (team) information and membership.

GitHub OpenAPI

Operations 3

GET /team Get authorized teams (workspaces) #
GET /team/{team_id}/seats Get workspace seats #
GET /team/{team_id}/user Get team members #

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-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:
    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.
    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.
  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