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	POST create-comment
penpot_collaboration_create_comment_thread	POST create-comment-thread
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	POST create-webhook
penpot_collaboration_delete_comment	POST delete-comment
penpot_collaboration_delete_comment_thread	POST delete-comment-thread
penpot_collaboration_delete_share_link	POST delete-share-link
penpot_collaboration_delete_webhook	POST delete-webhook
penpot_collaboration_get_comment_thread	POST get-comment-thread
penpot_collaboration_get_comment_threads	POST get-comment-threads
penpot_collaboration_get_comments	POST get-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	POST get-unread-comment-threads
penpot_collaboration_get_webhooks	POST get-webhooks
penpot_collaboration_mark_all_threads_as_read	POST mark-all-threads-as-read
penpot_collaboration_update_comment	POST update-comment
penpot_collaboration_update_comment_thread	POST update-comment-thread
penpot_collaboration_update_comment_thread_frame	POST update-comment-thread-frame
penpot_collaboration_update_comment_thread_position	POST update-comment-thread-position
penpot_collaboration_update_comment_thread_status	POST update-comment-thread-status
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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

penpot_collaboration_delete_share_link

POST delete-share-link

Parameters:

Parameter	Type	Required	Default	Description
id	string	Yes	—	UUID formatted string

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "UUID formatted string"
    }
  },
  "required": [
    "PCID",
    "id"
  ]
}

---

penpot_collaboration_delete_webhook

POST delete-webhook

Parameters:

Parameter	Type	Required	Default	Description
id	string	Yes	—	UUID formatted string

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "id": {
      "type": "string",
      "description": "UUID formatted string"
    }
  },
  "required": [
    "PCID",
    "id"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

penpot_collaboration_get_unread_comment_threads

POST get-unread-comment-threads

Parameters:

Parameter	Type	Required	Default	Description
teamId	string	Yes	—	UUID formatted string

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "teamId": {
      "type": "string",
      "description": "UUID formatted string"
    }
  },
  "required": [
    "PCID",
    "teamId"
  ]
}

---

penpot_collaboration_get_webhooks

POST get-webhooks

Parameters:

Parameter	Type	Required	Default	Description
teamId	string	Yes	—	UUID formatted string

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    },
    "teamId": {
      "type": "string",
      "description": "UUID formatted string"
    }
  },
  "required": [
    "PCID",
    "teamId"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}