> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Penpot

The Penpot connector lets your AI agent act in each user's Penpot account. Each user connects their own Penpot API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

**Authentication:** API Key
**Categories:** Design, Collaboration
**Tools:** 60: 26 read, 24 write, 10 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=PENPOT)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Penpot connection

   In **AgentKit > Connections**, create a Penpot connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'penpot'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Penpot:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'penpot_comment_threads_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "penpot"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Penpot:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="penpot_comment_threads_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Penpot credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'penpot_comment_thread_get',
  toolInput: {
    file_id: '<file_id>',
    id: '<id>',
  },
  connector: 'penpot',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="penpot_comment_thread_get",
    tool_input={
        "file_id": "<file_id>",
        "id": "<id>",
    },
    connection_name="penpot",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `penpot_comment_thread_get`

Get Comment Thread · Read-only

Get one comment thread of a file. Returns its page, position, status, owner and first comment. Use this when you know the thread ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `file_id` (`string`, required): ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
- `id` (`string`, required): ID (UUID) of the comment thread. Example: c6822969-a5ed-81c9-8008-f4ecb2349795.
- `share_id` (`string`, optional): Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.

Example input: `{"file_id":"<file_id>","id":"<id>"}`

### `penpot_comment_threads_list`

List Comment Threads · Read-only

List the comment threads of a file, or of every file in a team. Returns per thread its ID, page, position, status (resolved), owner, first comment and comment count. Use this to review feedback. Use penpot_comments_list for a thread's replies.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `file_id` (`string`, optional): ID (UUID) of the file. Give this or team_id. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
- `share_id` (`string`, optional): Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.
- `team_id` (`string`, optional): ID (UUID) of the team, to list threads across all its files. Give this or file_id. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{}`

### `penpot_comments_list`

List Thread Comments · Read-only

List the comments of one thread. Returns per comment its ID, content, owner, mentions and dates. Use this to read a discussion.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `thread_id` (`string`, required): ID (UUID) of the comment thread. Example: c6822969-a5ed-81c9-8008-f4ecb2349795.
- `share_id` (`string`, optional): Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.

Example input: `{"thread_id":"<thread_id>"}`

### `penpot_deleted_files_list`

List Deleted Files · Read-only

List a team's files that are marked for deletion and can still be restored. Returns per file its ID, name, project and deletion date. Use this before penpot_deleted_files_restore.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`string`, required): ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{"team_id":"<team_id>"}`

### `penpot_file_get_info`

Get File Info · Read-only

Get minimal information about one file. Returns its ID, name, project ID, team ID and revision. Use this to resolve a file ID cheaply.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID (UUID) of the file. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.

Example input: `{"id":"<id>"}`

### `penpot_file_libraries_list`

List File Libraries · Read-only

List the shared libraries a file uses. Returns per library its ID, name and sync status. Use this to see a file's design system dependencies.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `file_id` (`string`, required): ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.

Example input: `{"file_id":"<file_id>"}`

### `penpot_file_snapshots_list`

List File Versions · Read-only

List the saved versions (snapshots) of a file. Returns per version its ID, label, creation date, author and whether it is pinned. Use this before restoring a version.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `file_id` (`string`, required): ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.

Example input: `{"file_id":"<file_id>"}`

### `penpot_file_stats_get`

Get File Stats · Read-only

Get aggregate statistics for one file. Returns page count, shape counts by type and library asset counts. Use this to size up a design file.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID (UUID) of the file. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.

Example input: `{"id":"<id>"}`

### `penpot_file_summary_get`

Get File Summary · Read-only

Get a summary of one file's contents. Returns its name and the counts and names of its pages, components, colors and typographies. Use this to understand a file without downloading the whole design.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID (UUID) of the file. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.

Example input: `{"id":"<id>"}`

### `penpot_files_search`

Search Files · Read-only

Search a team's files by name. Returns matching files with ID, name, project and dates. Use this to find a file when you only know part of its name.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`string`, required): ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
- `search_term` (`string`, optional): Text to search file names for. Example: onboarding.

Example input: `{"team_id":"<team_id>"}`

### `penpot_library_usage_get`

Get Library Usage · Read-only

Get how many files use a shared library. Returns the count. Use this before changing or unpublishing a library.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `file_id` (`string`, required): ID (UUID) of the shared library file. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.

Example input: `{"file_id":"<file_id>"}`

### `penpot_page_get`

Get Page · Read-only

Get the data of one page of a file (its shapes and their properties), or of one object on it; without a page ID, returns the first page. Returns the page objects as JSON. Use this to inspect a design's layers. Use penpot_file_summary_get first to list the pages.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `file_id` (`string`, required): ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
- `object_id` (`string`, optional): ID (UUID) of one object (shape) to return instead of the whole page. Example: c6822969-a5ed-81c9-8008-f4ecb1300e99.
- `page_id` (`string`, optional): ID (UUID) of the page; leave empty for the file's first page. Example: c6822969-a5ed-81c9-8008-f4ecb1300e81.
- `share_id` (`string`, optional): Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.

Example input: `{"file_id":"<file_id>"}`

### `penpot_profile_get`

Get Profile · Read-only

Get the profile of the user the access token belongs to. Returns profile ID, full name, email, language, theme and default team and project IDs. Use this to check the connection or find your own profile ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `penpot_project_files_list`

List Project Files · Read-only

List the files of one project. Returns per file its ID, name, shared-library flag, revision and dates. Use this to find a file in a known project. Use penpot_files_search to find one by name across a team.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID (UUID) of the project. Find it with penpot_projects_list. Example: c6822969-a5ed-81c9-8008-f4ecb0dde99d.

Example input: `{"project_id":"<project_id>"}`

### `penpot_project_get`

Get Project · Read-only

Get one project by ID. Returns its name, team ID, pinned flag and dates. Use this when you know the project ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID (UUID) of the project. Example: c6822969-a5ed-81c9-8008-f4ecb0dde99d.

Example input: `{"id":"<id>"}`

### `penpot_projects_list`

List Projects · Read-only

List the projects of one team. Returns per project its ID, name, pinned flag, file count and dates. Use this to find a project. Use penpot_projects_list_all for every team at once.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`string`, required): ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{"team_id":"<team_id>"}`

### `penpot_projects_list_all`

List All Projects · Read-only

List the projects of every team you belong to. Returns per project its ID, name, team ID and name, and pinned flag. Use this when you do not know the team.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `penpot_team_get`

Get Team · Read-only

Get one team by its ID, or the team that owns a given file. Returns name, your permissions, default flag and features. Use this when you know the team ID or a file ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `file_id` (`string`, optional): ID (UUID) of a file; returns the team that owns it. Give this or id. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
- `id` (`string`, optional): ID (UUID) of the team. Give this or file_id. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.

Example input: `{}`

### `penpot_team_invitations_list`

List Team Invitations · Read-only

List the pending invitations of a team. Returns per invitation the email, role and expiry. Use this before resending or deleting an invitation.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`string`, required): ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{"team_id":"<team_id>"}`

### `penpot_team_members_list`

List Team Members · Read-only

List the members of a team. Returns per member the profile ID, name, email, role and photo. Use this to find member IDs for role changes, removals and comment mentions.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`string`, required): ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{"team_id":"<team_id>"}`

### `penpot_team_recent_files_list`

List Recent Team Files · Read-only

List the files of a team that changed most recently. Returns per file its ID, name, project and modification date. Use this to see recent work.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`string`, required): ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{"team_id":"<team_id>"}`

### `penpot_team_shared_files_list`

List Team Shared Libraries · Read-only

List the files of a team that are published as shared libraries. Returns per library its ID, name and project. Use this before linking a library with penpot_file_library_link.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`string`, required): ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{"team_id":"<team_id>"}`

### `penpot_team_stats_get`

Get Team Stats · Read-only

Get counts for a team. Returns the number of projects and files. Use this for a quick size check of a team.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`string`, required): ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{"team_id":"<team_id>"}`

### `penpot_teams_list`

List Teams · Read-only

List the teams you belong to, including your personal (default) team. Returns per team its ID, name, your role and permissions and feature flags. Use this first to get team IDs for the other tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `penpot_unread_comment_threads_list`

List Unread Comment Threads · Read-only

List the comment threads in a team that have comments you have not read. Returns per thread its ID, file, page and unread count. Use this to catch up on feedback.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`string`, required): ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{"team_id":"<team_id>"}`

### `penpot_webhooks_list`

List Webhooks · Read-only

List the webhooks of a team. Returns per webhook its ID, URL, payload format, active flag and error count. Use this to audit integrations.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `team_id` (`string`, required): ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{"team_id":"<team_id>"}`

### `penpot_comment_create`

Reply to Comment Thread · Write

Add a reply to a comment thread, optionally mentioning team members. Returns the new comment. Use penpot_comment_thread_create to start a new thread.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `content` (`string`, required): Comment text, up to 750 characters. Example: Can we make this button larger?.
- `thread_id` (`string`, required): ID (UUID) of the comment thread. Example: c6822969-a5ed-81c9-8008-f4ecb2349795.
- `mentions` (`array`, optional): Profile IDs (UUIDs) of team members to mention. Example: ["c6822969-a5ed-81c9-8008-f4ecb0ec0600"]
- `share_id` (`string`, optional): Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.

Example input: `{"content":"<content>","thread_id":"<thread_id>"}`

### `penpot_comment_thread_create`

Create Comment Thread · Write

Start a comment thread on a page of a file, pinned at a position, optionally mentioning team members (who get notified). Returns the new thread. Use penpot_comment_create to reply to an existing thread.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `content` (`string`, required): Comment text, up to 750 characters. Example: Can we make this button larger?.
- `file_id` (`string`, required): ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
- `frame_id` (`string`, required): ID (UUID) of the board (frame) the comment is pinned to; use 00000000-0000-0000-0000-000000000000 for the page root. Example: 00000000-0000-0000-0000-000000000000.
- `page_id` (`string`, required): ID (UUID) of the page inside the file, from penpot_file_get_info or penpot_file_summary_get. Example: c6822969-a5ed-81c9-8008-f4ecb1300e81.
- `position_x` (`number`, required): Horizontal position of the comment pin on the page, in canvas pixels. Example: 120.
- `position_y` (`number`, required): Vertical position of the comment pin on the page, in canvas pixels. Example: 80.
- `mentions` (`array`, optional): Profile IDs (UUIDs) of team members to mention. Example: ["c6822969-a5ed-81c9-8008-f4ecb0ec0600"]
- `share_id` (`string`, optional): Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.

Example input: `{"content":"<content>","file_id":"<file_id>","frame_id":"<frame_id>","page_id":"<page_id>","position_x":120,"position_y":80}`

### `penpot_comment_thread_resolve`

Resolve or Reopen Comment Thread · Write

Mark a comment thread as resolved, or reopen it. Returns nothing on success. Use this once feedback is addressed.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): ID (UUID) of the comment thread. Example: c6822969-a5ed-81c9-8008-f4ecb2349795.
- `is_resolved` (`boolean`, required): true to resolve the thread, false to reopen it. Example: true.
- `share_id` (`string`, optional): Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.

Example input: `{"id":"<id>","is_resolved":true}`

### `penpot_comment_update`

Update Comment · Write

Edit the text and mentions of one of your comments. Returns nothing on success. Use this to correct a comment.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `content` (`string`, required): Comment text, up to 750 characters. Example: Can we make this button larger?.
- `id` (`string`, required): ID (UUID) of the comment. Example: c6822969-a5ed-81c9-8008-f4ecb2349800.
- `mentions` (`array`, optional): Profile IDs (UUIDs) of team members to mention. Example: ["c6822969-a5ed-81c9-8008-f4ecb0ec0600"]
- `share_id` (`string`, optional): Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.

Example input: `{"content":"<content>","id":"<id>"}`

### `penpot_deleted_files_restore`

Restore Deleted Files · Write

Restore deleted files (and their projects) of a team that are still within the retention period. Returns nothing on success. Use penpot_deleted_files_list to find the IDs.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `ids` (`array`, required): IDs (UUIDs) of the files. Example: ["c6822969-a5ed-81c9-8008-f4ecb1300e80"]
- `team_id` (`string`, required): ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{"ids":["c6822969-a5ed-81c9-8008-f4ecb1300e80"],"team_id":"<team_id>"}`

### `penpot_file_create`

Create File · Write

Create an empty design file in a project. Returns the new file with its ID. Use penpot_file_rename to rename it later.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name of the file. Example: sk-test Login screens.
- `project_id` (`string`, required): ID (UUID) of the project. Find it with penpot_projects_list. Example: c6822969-a5ed-81c9-8008-f4ecb0dde99d.
- `is_shared` (`boolean`, optional): true to publish the new file as a shared library. Example: true.

Example input: `{"name":"<name>","project_id":"<project_id>"}`

### `penpot_file_duplicate`

Duplicate File · Write

Duplicate a file in the same project. Returns the new file. Use this to branch off a design.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `file_id` (`string`, required): ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
- `name` (`string`, optional): Name of the copy; defaults to the original name with a suffix. Example: sk-test Login screens (copy)

Example input: `{"file_id":"<file_id>"}`

### `penpot_file_library_link`

Link Library to File · Write

Link a shared library to a file so its components, colors and typographies can be used there. Returns the libraries now used by the file. Use penpot_team_shared_files_list to find libraries.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `file_id` (`string`, required): ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
- `library_id` (`string`, required): ID (UUID) of the shared library file. Example: c6822969-a5ed-81c9-8008-f4ecb2414493.

Example input: `{"file_id":"<file_id>","library_id":"<library_id>"}`

### `penpot_file_rename`

Rename File · Write

Rename a file. Returns the updated file. Use this to change a file's name.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): ID (UUID) of the file. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
- `name` (`string`, required): New file name. Example: sk-test Login screens v2.

Example input: `{"id":"<id>","name":"<name>"}`

### `penpot_file_shared_set`

Publish or Unpublish Library · Write

Publish a file as a shared library, or unpublish it. Returns the updated file. Use this so other files in the team can use its components, colors and typographies.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): ID (UUID) of the file. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
- `is_shared` (`boolean`, required): true to publish the file as a shared library, false to unpublish it. Example: true.

Example input: `{"id":"<id>","is_shared":true}`

### `penpot_file_snapshot_create`

Save File Version · Write

Save the current state of a file as a named version (snapshot). Returns the new version. Use this before risky changes.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `file_id` (`string`, required): ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
- `label` (`string`, optional): Label for the version (snapshot). Example: Before handoff.

Example input: `{"file_id":"<file_id>"}`

### `penpot_file_snapshot_restore`

Restore File Version · Write

Restore a file to a saved version, replacing its current content. Returns nothing on success. Use penpot_file_snapshots_list to find the version ID.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `file_id` (`string`, required): ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
- `id` (`string`, required): ID (UUID) of the version (snapshot) to restore. Example: c6822969-a5ed-81c9-8008-f4ecb0aa0001.

Example input: `{"file_id":"<file_id>","id":"<id>"}`

### `penpot_files_move`

Move Files · Write

Move one or more files to another project. Returns nothing on success. Use this to reorganise files between projects.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `ids` (`array`, required): IDs (UUIDs) of the files. Example: ["c6822969-a5ed-81c9-8008-f4ecb1300e80"]
- `project_id` (`string`, required): ID (UUID) of the destination project. Example: c6822969-a5ed-81c9-8008-f4ecb0dde99d.

Example input: `{"ids":["c6822969-a5ed-81c9-8008-f4ecb1300e80"],"project_id":"<project_id>"}`

### `penpot_project_create`

Create Project · Write

Create a project in a team. Returns the new project with its ID. Use penpot_file_create to add files to it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name of the project. Example: sk-test Mobile app.
- `team_id` (`string`, required): ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{"name":"<name>","team_id":"<team_id>"}`

### `penpot_project_duplicate`

Duplicate Project · Write

Duplicate a project with all its files, in the same team. Returns the new project. Use this to start from a copy.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project_id` (`string`, required): ID (UUID) of the project. Find it with penpot_projects_list. Example: c6822969-a5ed-81c9-8008-f4ecb0dde99d.
- `name` (`string`, optional): Name of the copy; defaults to the original name with a suffix. Example: sk-test Mobile app (copy)

Example input: `{"project_id":"<project_id>"}`

### `penpot_project_move`

Move Project · Write

Move a project with its files to another team you belong to. Returns nothing on success. Use this to reorganise work between teams.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project_id` (`string`, required): ID (UUID) of the project. Find it with penpot_projects_list. Example: c6822969-a5ed-81c9-8008-f4ecb0dde99d.
- `team_id` (`string`, required): ID (UUID) of the destination team. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{"project_id":"<project_id>","team_id":"<team_id>"}`

### `penpot_project_pin_update`

Pin or Unpin Project · Write

Pin or unpin a project in a team's dashboard. Returns nothing on success. Use this to keep a project at the top.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): ID (UUID) of the project. Example: c6822969-a5ed-81c9-8008-f4ecb0dde99d.
- `is_pinned` (`boolean`, required): true to pin the project, false to unpin it. Example: true.
- `team_id` (`string`, required): ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{"id":"<id>","is_pinned":true,"team_id":"<team_id>"}`

### `penpot_project_rename`

Rename Project · Write

Rename a project. Returns nothing on success. Use this to change a project's name.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): ID (UUID) of the project. Example: c6822969-a5ed-81c9-8008-f4ecb0dde99d.
- `name` (`string`, required): New project name. Example: sk-test Mobile app v2.

Example input: `{"id":"<id>","name":"<name>"}`

### `penpot_team_create`

Create Team · Write

Create a new team owned by you. Returns the new team with its ID. Use penpot_team_invitations_create to add people afterwards.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name of the team. Example: sk-test Design team.
- `is_default` (`boolean`, optional): Set to true to make it the default team. Example: false.
- `organization_id` (`string`, optional): ID (UUID) of the organization to create the team in (Penpot organizations only). Example: c6822969-a5ed-81c9-8008-f4ecb0ec0777.

Example input: `{"name":"<name>"}`

### `penpot_team_invitations_create`

Invite Team Members · Write

Invite one or more people by email to join a team with a role; Penpot emails each of them. Returns the created invitations. Use penpot_team_invitations_list to see pending ones.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `emails` (`array`, required): Email addresses to invite. Example: ["jane@example.com"]
- `role` (`string`, required): Team role: viewer, editor, admin or owner. One of: viewer, admin, editor, owner. Example: editor. One of: `viewer`, `admin`, `editor`, `owner`.
- `team_id` (`string`, required): ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{"emails":["jane@example.com"],"role":"viewer","team_id":"<team_id>"}`

### `penpot_team_member_role_update`

Update Team Member Role · Write

Change a team member's role to viewer, editor, admin or owner. Returns nothing on success. Use penpot_team_members_list to find the member ID.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `member_id` (`string`, required): Profile ID (UUID) of the team member. Example: c6822969-a5ed-81c9-8008-f4ecb0ec0600.
- `role` (`string`, required): Team role: viewer, editor, admin or owner. One of: viewer, admin, editor, owner. Example: editor. One of: `viewer`, `admin`, `editor`, `owner`.
- `team_id` (`string`, required): ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{"member_id":"<member_id>","role":"viewer","team_id":"<team_id>"}`

### `penpot_team_update`

Rename Team · Write

Rename a team. Returns nothing on success. Use this to change a team's name.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): ID (UUID) of the team. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
- `name` (`string`, required): New team name. Example: sk-test Design team 2.

Example input: `{"id":"<id>","name":"<name>"}`

### `penpot_webhook_create`

Create Webhook · Write

Create a team webhook that posts Penpot events (file, comment and project changes) to a URL. Returns the new webhook. Use penpot_webhook_update to change or pause it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `mtype` (`string`, required): Payload format: application/json or application/transit+json. One of: application/json, application/transit+json. Example: application/json. One of: `application/json`, `application/transit+json`.
- `team_id` (`string`, required): ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
- `uri` (`string`, required): HTTPS URL that receives the webhook events. Example: https://example.com/penpot-webhook.

Example input: `{"mtype":"application/json","team_id":"<team_id>","uri":"<uri>"}`

### `penpot_webhook_update`

Update Webhook · Write

Update a webhook's URL, payload format or active flag. Returns the updated webhook. Use this to pause or redirect a webhook.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): ID (UUID) of the webhook. Example: c6822969-a5ed-81c9-8008-f4ecb0bb0001.
- `is_active` (`boolean`, required): true to enable the webhook, false to pause it. Example: true.
- `mtype` (`string`, required): Payload format: application/json or application/transit+json. One of: application/json, application/transit+json. Example: application/json. One of: `application/json`, `application/transit+json`.
- `uri` (`string`, required): HTTPS URL that receives the webhook events. Example: https://example.com/penpot-webhook.

Example input: `{"id":"<id>","is_active":true,"mtype":"application/json","uri":"<uri>"}`

### `penpot_comment_delete`

Delete Comment · Destructive

Delete one comment. Returns nothing on success. Use penpot_comment_thread_delete to remove a whole thread.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): ID (UUID) of the comment. Example: c6822969-a5ed-81c9-8008-f4ecb2349800.
- `share_id` (`string`, optional): Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.

Example input: `{"id":"<id>"}`

### `penpot_comment_thread_delete`

Delete Comment Thread · Destructive

Delete a comment thread with all its comments. Returns nothing on success. Use penpot_comment_thread_resolve to close it instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): ID (UUID) of the comment thread. Example: c6822969-a5ed-81c9-8008-f4ecb2349795.
- `share_id` (`string`, optional): Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.

Example input: `{"id":"<id>"}`

### `penpot_file_delete`

Delete File · Destructive

Delete a file; Penpot keeps it recoverable for a while. Returns nothing on success. Use penpot_deleted_files_restore to undo within the retention period.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): ID (UUID) of the file. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.

Example input: `{"id":"<id>"}`

### `penpot_file_library_unlink`

Unlink Library from File · Destructive

Unlink a shared library from a file. Returns nothing on success. Use this to remove a design system dependency.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `file_id` (`string`, required): ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
- `library_id` (`string`, required): ID (UUID) of the shared library file. Example: c6822969-a5ed-81c9-8008-f4ecb2414493.

Example input: `{"file_id":"<file_id>","library_id":"<library_id>"}`

### `penpot_file_snapshot_delete`

Delete File Version · Destructive

Delete a saved version (snapshot) of a file. Returns nothing on success. Use this to remove an outdated version.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): ID (UUID) of the version (snapshot). Example: c6822969-a5ed-81c9-8008-f4ecb0aa0001.

Example input: `{"id":"<id>"}`

### `penpot_project_delete`

Delete Project · Destructive

Delete a project and all its files; Penpot keeps deleted files recoverable for a while. Returns nothing on success. Use penpot_deleted_files_restore to undo within the retention period.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): ID (UUID) of the project. Example: c6822969-a5ed-81c9-8008-f4ecb0dde99d.

Example input: `{"id":"<id>"}`

### `penpot_team_delete`

Delete Team · Destructive

Delete a team with all its projects and files. Returns nothing on success. Use this only to remove a whole team; your personal team cannot be deleted.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): ID (UUID) of the team. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{"id":"<id>"}`

### `penpot_team_invitation_delete`

Delete Team Invitation · Destructive

Cancel a pending invitation to a team by email. Returns nothing on success. Use this to withdraw an invitation.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `email` (`string`, required): Email address of the invitation. Example: jane@example.com.
- `team_id` (`string`, required): ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{"email":"<email>","team_id":"<team_id>"}`

### `penpot_team_member_delete`

Remove Team Member · Destructive

Remove a member from a team. Returns nothing on success. Use this to revoke someone's access to a team.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `member_id` (`string`, required): Profile ID (UUID) of the team member. Example: c6822969-a5ed-81c9-8008-f4ecb0ec0600.
- `team_id` (`string`, required): ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.

Example input: `{"member_id":"<member_id>","team_id":"<team_id>"}`

### `penpot_webhook_delete`

Delete Webhook · Destructive

Delete a team webhook. Returns nothing on success. Use penpot_webhook_update with is_active false to pause it instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): ID (UUID) of the webhook. Example: c6822969-a5ed-81c9-8008-f4ecb0bb0001.

Example input: `{"id":"<id>"}`

## Related

Other Design connectors ([all 34](/agentkit/connectors/?category=design)):

- [Figma](/agentkit/connectors/figma/): Scalekit connector, OAuth, 54 tools
- [Miro](/agentkit/connectors/miro/): Scalekit connector, OAuth, 115 tools
- [Mural](/agentkit/connectors/mural/): Scalekit connector, OAuth, 61 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
