> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# penpot-collaboration

> Penpot Collaboration - manage comments, webhooks, and share links

**Server path:** `/penpot-collaboration` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                                          | Description                                                                                                                                                                    |
| ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [`penpot_collaboration_create_comment`](#penpot_collaboration_create_comment)                                 | POST create-comment                                                                                                                                                            |
| [`penpot_collaboration_create_comment_thread`](#penpot_collaboration_create_comment_thread)                   | POST create-comment-thread                                                                                                                                                     |
| [`penpot_collaboration_create_share_link`](#penpot_collaboration_create_share_link)                           | Creates a share-link object.  Share links are resources that allows external users access to specific pages of a file with specific permissions (who-comment and who-inspect). |
| [`penpot_collaboration_create_webhook`](#penpot_collaboration_create_webhook)                                 | POST create-webhook                                                                                                                                                            |
| [`penpot_collaboration_delete_comment`](#penpot_collaboration_delete_comment)                                 | POST delete-comment                                                                                                                                                            |
| [`penpot_collaboration_delete_comment_thread`](#penpot_collaboration_delete_comment_thread)                   | POST delete-comment-thread                                                                                                                                                     |
| [`penpot_collaboration_delete_share_link`](#penpot_collaboration_delete_share_link)                           | POST delete-share-link                                                                                                                                                         |
| [`penpot_collaboration_delete_webhook`](#penpot_collaboration_delete_webhook)                                 | POST delete-webhook                                                                                                                                                            |
| [`penpot_collaboration_get_comment_thread`](#penpot_collaboration_get_comment_thread)                         | POST get-comment-thread                                                                                                                                                        |
| [`penpot_collaboration_get_comment_threads`](#penpot_collaboration_get_comment_threads)                       | POST get-comment-threads                                                                                                                                                       |
| [`penpot_collaboration_get_comments`](#penpot_collaboration_get_comments)                                     | POST get-comments                                                                                                                                                              |
| [`penpot_collaboration_get_profiles_for_file_comments`](#penpot_collaboration_get_profiles_for_file_comments) | Retrieves a list of profiles with limited set of properties of all participants on comment threads of the file.                                                                |
| [`penpot_collaboration_get_unread_comment_threads`](#penpot_collaboration_get_unread_comment_threads)         | POST get-unread-comment-threads                                                                                                                                                |
| [`penpot_collaboration_get_webhooks`](#penpot_collaboration_get_webhooks)                                     | POST get-webhooks                                                                                                                                                              |
| [`penpot_collaboration_mark_all_threads_as_read`](#penpot_collaboration_mark_all_threads_as_read)             | POST mark-all-threads-as-read                                                                                                                                                  |
| [`penpot_collaboration_update_comment`](#penpot_collaboration_update_comment)                                 | POST update-comment                                                                                                                                                            |
| [`penpot_collaboration_update_comment_thread`](#penpot_collaboration_update_comment_thread)                   | POST update-comment-thread                                                                                                                                                     |
| [`penpot_collaboration_update_comment_thread_frame`](#penpot_collaboration_update_comment_thread_frame)       | POST update-comment-thread-frame                                                                                                                                               |
| [`penpot_collaboration_update_comment_thread_position`](#penpot_collaboration_update_comment_thread_position) | POST update-comment-thread-position                                                                                                                                            |
| [`penpot_collaboration_update_comment_thread_status`](#penpot_collaboration_update_comment_thread_status)     | POST update-comment-thread-status                                                                                                                                              |
| [`penpot_collaboration_update_webhook`](#penpot_collaboration_update_webhook)                                 | POST update-webhook                                                                                                                                                            |

***

## penpot\_collaboration\_create\_comment

POST create-comment

**Parameters:**

| Parameter  | Type      | Required | Default | Description           |
| ---------- | --------- | -------- | ------- | --------------------- |
| `content`  | string    | Yes      | —       | The content value     |
| `mentions` | string\[] | No       | —       | Set of Strings        |
| `shareId`  | string    | No       | —       | UUID formatted string |
| `threadId` | string    | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "content": {
        "type": "string",
        "description": "The content value"
      },
      "mentions": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uuid"
        },
        "description": "Set of Strings"
      },
      "shareId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "threadId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "content",
      "threadId"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_create\_comment\_thread

POST create-comment-thread

**Parameters:**

| Parameter  | Type      | Required | Default | Description                         |
| ---------- | --------- | -------- | ------- | ----------------------------------- |
| `content`  | string    | Yes      | —       | The content value                   |
| `fileId`   | string    | Yes      | —       | UUID formatted string               |
| `frameId`  | string    | Yes      | —       | UUID formatted string               |
| `mentions` | string\[] | No       | —       | Set of Strings                      |
| `pageId`   | string    | Yes      | —       | UUID formatted string               |
| `position` | object    | Yes      | —       | A 2D point with x and y coordinates |
| `shareId`  | string    | No       | —       | UUID formatted string               |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "content": {
        "type": "string",
        "description": "The content value"
      },
      "fileId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "frameId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "mentions": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uuid"
        },
        "description": "Set of Strings"
      },
      "pageId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "position": {
        "type": "object",
        "description": "A 2D point with x and y coordinates",
        "properties": {
          "x": {
            "type": "number",
            "description": "X coordinate"
          },
          "y": {
            "type": "number",
            "description": "Y coordinate"
          }
        },
        "required": [
          "x",
          "y"
        ]
      },
      "shareId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "content",
      "fileId",
      "frameId",
      "pageId",
      "position"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_create\_share\_link

Creates a share-link object.  Share links are resources that allows external users access to specific pages of a file with specific permissions (who-comment and who-inspect).

**Parameters:**

| Parameter    | Type      | Required | Default | Description           |
| ------------ | --------- | -------- | ------- | --------------------- |
| `fileId`     | string    | Yes      | —       | UUID formatted string |
| `pages`      | string\[] | Yes      | —       | The pages value       |
| `whoComment` | string    | Yes      | —       | Who Comment           |
| `whoInspect` | string    | Yes      | —       | Who Inspect           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "fileId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "pages": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uuid"
        },
        "description": "The pages value"
      },
      "whoComment": {
        "type": "string",
        "description": "Who Comment"
      },
      "whoInspect": {
        "type": "string",
        "description": "Who Inspect"
      }
    },
    "required": [
      "PCID",
      "fileId",
      "pages",
      "whoComment",
      "whoInspect"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_create\_webhook

POST create-webhook

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `mtype`   | string | Yes      | —       | The mtype value       |
| `teamId`  | string | Yes      | —       | UUID formatted string |
| `uri`     | string | Yes      | —       | URI formatted string  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "mtype": {
        "type": "string",
        "description": "The mtype value",
        "enum": [
          "application/json",
          "application/transit+json"
        ]
      },
      "teamId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "uri": {
        "type": "string",
        "description": "URI formatted string"
      }
    },
    "required": [
      "PCID",
      "mtype",
      "teamId",
      "uri"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_delete\_comment

POST delete-comment

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `id`      | string | Yes      | —       | UUID formatted string |
| `shareId` | string | No       | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "shareId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_delete\_comment\_thread

POST delete-comment-thread

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `id`      | string | Yes      | —       | UUID formatted string |
| `shareId` | string | No       | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "shareId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_delete\_share\_link

POST delete-share-link

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `id`      | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_delete\_webhook

POST delete-webhook

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `id`      | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_get\_comment\_thread

POST get-comment-thread

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `fileId`  | string | Yes      | —       | UUID formatted string |
| `id`      | string | Yes      | —       | UUID formatted string |
| `shareId` | string | No       | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "fileId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "shareId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "fileId",
      "id"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_get\_comment\_threads

POST get-comment-threads

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `fileId`  | string | No       | —       | UUID formatted string |
| `shareId` | string | No       | —       | UUID formatted string |
| `teamId`  | string | No       | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "fileId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "shareId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "teamId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_get\_comments

POST get-comments

**Parameters:**

| Parameter  | Type   | Required | Default | Description           |
| ---------- | ------ | -------- | ------- | --------------------- |
| `shareId`  | string | No       | —       | UUID formatted string |
| `threadId` | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "shareId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "threadId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "threadId"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_get\_profiles\_for\_file\_comments

Retrieves a list of profiles with limited set of properties of all participants on comment threads of the file.

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `fileId`  | string | Yes      | —       | UUID formatted string |
| `shareId` | string | No       | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "fileId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "shareId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "fileId"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_get\_unread\_comment\_threads

POST get-unread-comment-threads

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `teamId`  | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "teamId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "teamId"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_get\_webhooks

POST get-webhooks

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `teamId`  | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "teamId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "teamId"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_mark\_all\_threads\_as\_read

POST mark-all-threads-as-read

**Parameters:**

| Parameter | Type      | Required | Default | Description       |
| --------- | --------- | -------- | ------- | ----------------- |
| `threads` | string\[] | Yes      | —       | The threads value |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "threads": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uuid"
        },
        "description": "The threads value"
      }
    },
    "required": [
      "PCID",
      "threads"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_update\_comment

POST update-comment

**Parameters:**

| Parameter  | Type      | Required | Default | Description           |
| ---------- | --------- | -------- | ------- | --------------------- |
| `content`  | string    | Yes      | —       | The content value     |
| `id`       | string    | Yes      | —       | UUID formatted string |
| `mentions` | string\[] | No       | —       | Set of Strings        |
| `shareId`  | string    | No       | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "content": {
        "type": "string",
        "description": "The content value"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "mentions": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uuid"
        },
        "description": "Set of Strings"
      },
      "shareId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "content",
      "id"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_update\_comment\_thread

POST update-comment-thread

**Parameters:**

| Parameter    | Type    | Required | Default | Description           |
| ------------ | ------- | -------- | ------- | --------------------- |
| `id`         | string  | Yes      | —       | UUID formatted string |
| `isResolved` | boolean | Yes      | —       | Is Resolved           |
| `shareId`    | string  | No       | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "isResolved": {
        "type": "boolean",
        "description": "Is Resolved"
      },
      "shareId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "id",
      "isResolved"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_update\_comment\_thread\_frame

POST update-comment-thread-frame

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `frameId` | string | Yes      | —       | UUID formatted string |
| `id`      | string | Yes      | —       | UUID formatted string |
| `shareId` | string | No       | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "frameId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "shareId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "frameId",
      "id"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_update\_comment\_thread\_position

POST update-comment-thread-position

**Parameters:**

| Parameter  | Type   | Required | Default | Description                         |
| ---------- | ------ | -------- | ------- | ----------------------------------- |
| `frameId`  | string | Yes      | —       | UUID formatted string               |
| `id`       | string | Yes      | —       | UUID formatted string               |
| `position` | object | Yes      | —       | A 2D point with x and y coordinates |
| `shareId`  | string | No       | —       | UUID formatted string               |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "frameId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "position": {
        "type": "object",
        "description": "A 2D point with x and y coordinates",
        "properties": {
          "x": {
            "type": "number",
            "description": "X coordinate"
          },
          "y": {
            "type": "number",
            "description": "Y coordinate"
          }
        },
        "required": [
          "x",
          "y"
        ]
      },
      "shareId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "frameId",
      "id",
      "position"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_update\_comment\_thread\_status

POST update-comment-thread-status

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `id`      | string | Yes      | —       | UUID formatted string |
| `shareId` | string | No       | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "shareId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## penpot\_collaboration\_update\_webhook

POST update-webhook

**Parameters:**

| Parameter  | Type    | Required | Default | Description           |
| ---------- | ------- | -------- | ------- | --------------------- |
| `id`       | string  | Yes      | —       | UUID formatted string |
| `isActive` | boolean | Yes      | —       | boolean               |
| `mtype`    | string  | Yes      | —       | The mtype value       |
| `uri`      | string  | Yes      | —       | URI formatted string  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "isActive": {
        "type": "boolean",
        "description": "boolean"
      },
      "mtype": {
        "type": "string",
        "description": "The mtype value",
        "enum": [
          "application/json",
          "application/transit+json"
        ]
      },
      "uri": {
        "type": "string",
        "description": "URI formatted string"
      }
    },
    "required": [
      "PCID",
      "id",
      "isActive",
      "mtype",
      "uri"
    ]
  }
  ```
</Expandable>