Clickup Shared Hierarchy API

The Shared Hierarchy API from Clickup — 1 operation(s) for shared hierarchy.

Operations 1

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}/shared See tasks, Lists and Folders shared with me · Shared Hierarchy #
Ask an LLM
“Which tasks, Lists and Folders have been shared with me in a Workspace?”
“Can I see items shared with me that aren't in my own Spaces?”
Tell an agent
Show everything shared with me in Workspace {team_id}.
List the tasks, Lists and Folders shared with me in Workspace {team_id}.

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-shared-hierarchy-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.

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

OpenAPI Specification

clickup-shared-hierarchy-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: ClickUp API v2 Reference Shared Hierarchy 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:
- name: Shared Hierarchy
paths:
  /v2/team/{team_id}/shared:
    parameters: []
    get:
      summary: Shared Hierarchy
      tags:
      - Shared Hierarchy
      description: View the tasks, Lists, and Folders that have been shared with the authenticated user.
      operationId: SharedHierarchy
      parameters:
      - name: team_id
        in: path
        description: Workspace ID
        required: true
        style: simple
        schema:
          type: number
          contentEncoding: double
          examples:
          - 123
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                title: SharedHierarchyresponse
                required:
                - shared
                type: object
                properties:
                  shared:
                    title: Shared7
                    required:
                    - tasks
                    - lists
                    - folders
                    type: object
                    properties:
                      tasks:
                        type: array
                        items:
                          type: string
                        description: ''
                      lists:
                        type: array
                        items:
                          title: List6
                          required:
                          - id
                          - name
                          - orderindex
                          - content
                          - status
                          - priority
                          - assignee
                          - task_count
                          - due_date
                          - start_date
                          - archived
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            orderindex:
                              type: integer
                              contentEncoding: int32
                            content:
                              type:
                              - string
                              - 'null'
                            status:
                              type:
                              - string
                              - 'null'
                            priority:
                              type:
                              - string
                              - 'null'
                            assignee:
                              type:
                              - string
                              - 'null'
                            task_count:
                              type: string
                            due_date:
                              type:
                              - string
                              - 'null'
                            start_date:
                              type:
                              - string
                              - 'null'
                            archived:
                              type: boolean
                          examples:
                          - id: '1421'
                            name: Shared List
                            orderindex: 0
                            content: null
                            status: null
                            priority: null
                            assignee: null
                            task_count: '0'
                            due_date: null
                            start_date: null
                            archived: false
                        description: ''
                      folders:
                        type: array
                        items:
                          title: Folder11
                          required:
                          - id
                          - name
                          - orderindex
                          - content
                          - task_count
                          - due_date
                          - archived
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                            orderindex:
                              type: integer
                              contentEncoding: int32
                            content:
                              type:
                              - string
                              - 'null'
                            task_count:
                              type: string
                            due_date:
                              type:
                              - string
                              - 'null'
                            archived:
                              type: boolean
                          examples:
                          - id: '1058'
                            name: Shared Folder
                            orderindex: 0
                            content: null
                            task_count: '0'
                            due_date: null
                            archived: false
                        description: ''
                    examples:
                    - tasks: []
                      lists:
                      - id: '1421'
                        name: Shared List
                        orderindex: 0
                        content: null
                        status: null
                        priority: null
                        assignee: null
                        task_count: '0'
                        due_date: null
                        start_date: null
                        archived: false
                      folders:
                      - id: '1058'
                        name: Shared Folder
                        orderindex: 0
                        content: null
                        task_count: '0'
                        due_date: null
                        archived: false
                examples:
                - shared:
                    tasks: []
                    lists:
                    - id: '1421'
                      name: Shared List
                      orderindex: 0
                      content: null
                      status: null
                      priority: null
                      assignee: null
                      task_count: '0'
                      due_date: null
                      start_date: null
                      archived: false
                    folders:
                    - id: '1058'
                      name: Shared Folder
                      orderindex: 0
                      content: null
                      task_count: '0'
                      due_date: null
                      archived: false
              example:
                shared:
                  tasks: []
                  lists:
                  - id: '1421'
                    name: Shared List
                    orderindex: 0
                    content: null
                    status: null
                    priority: null
                    assignee: null
                    task_count: '0'
                    due_date: null
                    start_date: null
                    archived: false
                  folders:
                  - id: '1058'
                    name: Shared Folder
                    orderindex: 0
                    content: null
                    task_count: '0'
                    due_date: null
                    archived: false
      deprecated: false
components:
  securitySchemes:
    Authorization_Token:
      name: Authorization
      type: apiKey
      in: header
      description: 'API token required for authentication. Two types of tokens are supported:

        **Personal API Key** Obtain from ClickUp''s settings page under ''Apps'' and add it to the header as `Authorization: pk_...`

        **OAuth2 Access Token** Generated through the OAuth2 flow and add it to the header as `Authorization: Bearer {access_token}`'