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.
- Tools
- 60
- What they doRead · write · destructive
- 26 · 24 · 1026 read24 write10 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Penpot connection
In AgentKit > Connections, create a Penpot connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts 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.actionsconst connector = 'penpot'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'penpot_comment_threads_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "penpot"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="penpot_comment_threads_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Penpot credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolpenpot_comment_thread_getGet one comment thread of a file.Read-onlyGet Comment Thread
Get one comment thread of a file. Returns its page, position, status, owner and first comment. Use this when you know the thread ID.
Inputs
file_idstringrequired- ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
idstringrequired- ID (UUID) of the comment thread. Example: c6822969-a5ed-81c9-8008-f4ecb2349795.
share_idstring- Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.
penpot_comment_threads_listList the comment threads of a file, or of every file in a team.Read-onlyList Comment Threads
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.
Inputs
file_idstring- ID (UUID) of the file. Give this or team_id. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
share_idstring- Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.
team_idstring- ID (UUID) of the team, to list threads across all its files. Give this or file_id. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
penpot_comments_listList the comments of one thread.Read-onlyList Thread Comments
List the comments of one thread. Returns per comment its ID, content, owner, mentions and dates. Use this to read a discussion.
Inputs
thread_idstringrequired- ID (UUID) of the comment thread. Example: c6822969-a5ed-81c9-8008-f4ecb2349795.
share_idstring- Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.
penpot_deleted_files_listList a team's files that are marked for deletion and can still be restored.Read-onlyList Deleted Files
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.
Inputs
team_idstringrequired- ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
penpot_file_get_infoGet minimal information about one file.Read-onlyGet File Info
Get minimal information about one file. Returns its ID, name, project ID, team ID and revision. Use this to resolve a file ID cheaply.
Inputs
idstringrequired- ID (UUID) of the file. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
penpot_file_libraries_listList the shared libraries a file uses.Read-onlyList File Libraries
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.
Inputs
file_idstringrequired- ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
penpot_file_snapshots_listList the saved versions (snapshots) of a file.Read-onlyList File Versions
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.
Inputs
file_idstringrequired- ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
penpot_file_stats_getGet aggregate statistics for one file.Read-onlyGet File Stats
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.
Inputs
idstringrequired- ID (UUID) of the file. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
penpot_file_summary_getGet a summary of one file's contents.Read-onlyGet File Summary
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.
Inputs
idstringrequired- ID (UUID) of the file. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
penpot_files_searchSearch a team's files by name.Read-onlySearch Files
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.
Inputs
team_idstringrequired- ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
search_termstring- Text to search file names for. Example: onboarding.
penpot_library_usage_getGet how many files use a shared library.Read-onlyGet Library Usage
Get how many files use a shared library. Returns the count. Use this before changing or unpublishing a library.
Inputs
file_idstringrequired- ID (UUID) of the shared library file. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
penpot_page_getGet 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.Read-onlyGet Page
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.
Inputs
file_idstringrequired- ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
object_idstring- ID (UUID) of one object (shape) to return instead of the whole page. Example: c6822969-a5ed-81c9-8008-f4ecb1300e99.
page_idstring- ID (UUID) of the page; leave empty for the file's first page. Example: c6822969-a5ed-81c9-8008-f4ecb1300e81.
share_idstring- Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.
penpot_profile_getGet the profile of the user the access token belongs to.Read-onlyGet Profile
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.
Inputs
This tool takes no inputs.
penpot_project_files_listList the files of one project.Read-onlyList Project Files
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.
Inputs
project_idstringrequired- ID (UUID) of the project. Find it with penpot_projects_list. Example: c6822969-a5ed-81c9-8008-f4ecb0dde99d.
penpot_project_getGet one project by ID.Read-onlyGet Project
Get one project by ID. Returns its name, team ID, pinned flag and dates. Use this when you know the project ID.
Inputs
idstringrequired- ID (UUID) of the project. Example: c6822969-a5ed-81c9-8008-f4ecb0dde99d.
penpot_projects_listList the projects of one team.Read-onlyList Projects
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.
Inputs
team_idstringrequired- ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
penpot_projects_list_allList the projects of every team you belong to.Read-onlyList All Projects
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.
Inputs
This tool takes no inputs.
penpot_team_getGet one team by its ID, or the team that owns a given file.Read-onlyGet Team
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.
Inputs
file_idstring- ID (UUID) of a file; returns the team that owns it. Give this or id. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
idstring- ID (UUID) of the team. Give this or file_id. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
penpot_team_invitations_listList the pending invitations of a team.Read-onlyList Team Invitations
List the pending invitations of a team. Returns per invitation the email, role and expiry. Use this before resending or deleting an invitation.
Inputs
team_idstringrequired- ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
penpot_team_members_listList the members of a team.Read-onlyList Team Members
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.
Inputs
team_idstringrequired- ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
penpot_team_recent_files_listList the files of a team that changed most recently.Read-onlyList Recent Team Files
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.
Inputs
team_idstringrequired- ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
penpot_team_stats_getGet counts for a team.Read-onlyGet Team Stats
Get counts for a team. Returns the number of projects and files. Use this for a quick size check of a team.
Inputs
team_idstringrequired- ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
penpot_teams_listList the teams you belong to, including your personal (default) team.Read-onlyList Teams
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.
Inputs
This tool takes no inputs.
penpot_unread_comment_threads_listList the comment threads in a team that have comments you have not read.Read-onlyList Unread Comment Threads
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.
Inputs
team_idstringrequired- ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
penpot_webhooks_listList the webhooks of a team.Read-onlyList Webhooks
List the webhooks of a team. Returns per webhook its ID, URL, payload format, active flag and error count. Use this to audit integrations.
Inputs
team_idstringrequired- ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
penpot_comment_createAdd a reply to a comment thread, optionally mentioning team members.WriteReply to Comment Thread
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.
Inputs
contentstringrequired- Comment text, up to 750 characters. Example: Can we make this button larger?.
thread_idstringrequired- ID (UUID) of the comment thread. Example: c6822969-a5ed-81c9-8008-f4ecb2349795.
mentionsarray- Profile IDs (UUIDs) of team members to mention. Example: ["c6822969-a5ed-81c9-8008-f4ecb0ec0600"]
share_idstring- Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.
penpot_comment_thread_createStart a comment thread on a page of a file, pinned at a position, optionally mentioning team members (who get notified).WriteCreate Comment Thread
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.
Inputs
contentstringrequired- Comment text, up to 750 characters. Example: Can we make this button larger?.
file_idstringrequired- ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
frame_idstringrequired- 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_idstringrequired- 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_xnumberrequired- Horizontal position of the comment pin on the page, in canvas pixels. Example: 120.
position_ynumberrequired- Vertical position of the comment pin on the page, in canvas pixels. Example: 80.
mentionsarray- Profile IDs (UUIDs) of team members to mention. Example: ["c6822969-a5ed-81c9-8008-f4ecb0ec0600"]
share_idstring- Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.
penpot_comment_thread_resolveMark a comment thread as resolved, or reopen it.WriteResolve or Reopen Comment Thread
Mark a comment thread as resolved, or reopen it. Returns nothing on success. Use this once feedback is addressed.
Inputs
idstringrequired- ID (UUID) of the comment thread. Example: c6822969-a5ed-81c9-8008-f4ecb2349795.
is_resolvedbooleanrequired- true to resolve the thread, false to reopen it. Example: true.
share_idstring- Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.
penpot_comment_updateEdit the text and mentions of one of your comments.WriteUpdate Comment
Edit the text and mentions of one of your comments. Returns nothing on success. Use this to correct a comment.
Inputs
contentstringrequired- Comment text, up to 750 characters. Example: Can we make this button larger?.
idstringrequired- ID (UUID) of the comment. Example: c6822969-a5ed-81c9-8008-f4ecb2349800.
mentionsarray- Profile IDs (UUIDs) of team members to mention. Example: ["c6822969-a5ed-81c9-8008-f4ecb0ec0600"]
share_idstring- Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.
penpot_deleted_files_restoreRestore deleted files (and their projects) of a team that are still within the retention period.WriteRestore Deleted Files
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.
Inputs
idsarrayrequired- IDs (UUIDs) of the files. Example: ["c6822969-a5ed-81c9-8008-f4ecb1300e80"]
team_idstringrequired- ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
penpot_file_createCreate an empty design file in a project.WriteCreate File
Create an empty design file in a project. Returns the new file with its ID. Use penpot_file_rename to rename it later.
Inputs
namestringrequired- Name of the file. Example: sk-test Login screens.
project_idstringrequired- ID (UUID) of the project. Find it with penpot_projects_list. Example: c6822969-a5ed-81c9-8008-f4ecb0dde99d.
is_sharedboolean- true to publish the new file as a shared library. Example: true.
penpot_file_duplicateDuplicate a file in the same project.WriteDuplicate File
Duplicate a file in the same project. Returns the new file. Use this to branch off a design.
Inputs
file_idstringrequired- ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
namestring- Name of the copy; defaults to the original name with a suffix. Example: sk-test Login screens (copy)
penpot_file_library_linkLink a shared library to a file so its components, colors and typographies can be used there.WriteLink Library to File
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.
Inputs
file_idstringrequired- ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
library_idstringrequired- ID (UUID) of the shared library file. Example: c6822969-a5ed-81c9-8008-f4ecb2414493.
penpot_file_renameRename a file.WriteRename File
Rename a file. Returns the updated file. Use this to change a file's name.
Inputs
idstringrequired- ID (UUID) of the file. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
namestringrequired- New file name. Example: sk-test Login screens v2.
penpot_file_snapshot_createSave the current state of a file as a named version (snapshot).WriteSave File Version
Save the current state of a file as a named version (snapshot). Returns the new version. Use this before risky changes.
Inputs
file_idstringrequired- ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
labelstring- Label for the version (snapshot). Example: Before handoff.
penpot_file_snapshot_restoreRestore a file to a saved version, replacing its current content.WriteRestore File Version
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.
Inputs
file_idstringrequired- ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
idstringrequired- ID (UUID) of the version (snapshot) to restore. Example: c6822969-a5ed-81c9-8008-f4ecb0aa0001.
penpot_files_moveMove one or more files to another project.WriteMove Files
Move one or more files to another project. Returns nothing on success. Use this to reorganise files between projects.
Inputs
idsarrayrequired- IDs (UUIDs) of the files. Example: ["c6822969-a5ed-81c9-8008-f4ecb1300e80"]
project_idstringrequired- ID (UUID) of the destination project. Example: c6822969-a5ed-81c9-8008-f4ecb0dde99d.
penpot_project_createCreate a project in a team.WriteCreate Project
Create a project in a team. Returns the new project with its ID. Use penpot_file_create to add files to it.
Inputs
namestringrequired- Name of the project. Example: sk-test Mobile app.
team_idstringrequired- ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
penpot_project_duplicateDuplicate a project with all its files, in the same team.WriteDuplicate Project
Duplicate a project with all its files, in the same team. Returns the new project. Use this to start from a copy.
Inputs
project_idstringrequired- ID (UUID) of the project. Find it with penpot_projects_list. Example: c6822969-a5ed-81c9-8008-f4ecb0dde99d.
namestring- Name of the copy; defaults to the original name with a suffix. Example: sk-test Mobile app (copy)
penpot_project_moveMove a project with its files to another team you belong to.WriteMove Project
Move a project with its files to another team you belong to. Returns nothing on success. Use this to reorganise work between teams.
Inputs
project_idstringrequired- ID (UUID) of the project. Find it with penpot_projects_list. Example: c6822969-a5ed-81c9-8008-f4ecb0dde99d.
team_idstringrequired- ID (UUID) of the destination team. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
penpot_project_pin_updatePin or unpin a project in a team's dashboard.WritePin or Unpin Project
Pin or unpin a project in a team's dashboard. Returns nothing on success. Use this to keep a project at the top.
Inputs
idstringrequired- ID (UUID) of the project. Example: c6822969-a5ed-81c9-8008-f4ecb0dde99d.
is_pinnedbooleanrequired- true to pin the project, false to unpin it. Example: true.
team_idstringrequired- ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
penpot_project_renameRename a project.WriteRename Project
Rename a project. Returns nothing on success. Use this to change a project's name.
Inputs
idstringrequired- ID (UUID) of the project. Example: c6822969-a5ed-81c9-8008-f4ecb0dde99d.
namestringrequired- New project name. Example: sk-test Mobile app v2.
penpot_team_createCreate a new team owned by you.WriteCreate Team
Create a new team owned by you. Returns the new team with its ID. Use penpot_team_invitations_create to add people afterwards.
Inputs
namestringrequired- Name of the team. Example: sk-test Design team.
is_defaultboolean- Set to true to make it the default team. Example: false.
organization_idstring- ID (UUID) of the organization to create the team in (Penpot organizations only). Example: c6822969-a5ed-81c9-8008-f4ecb0ec0777.
penpot_team_invitations_createInvite one or more people by email to join a team with a role; Penpot emails each of them.WriteInvite Team Members
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.
Inputs
emailsarrayrequired- Email addresses to invite. Example: ["jane@example.com"]
rolestringrequired- Team role: viewer, editor, admin or owner. One of: viewer, admin, editor, owner. Example: editor.one of
vieweradmineditorowner team_idstringrequired- ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
penpot_team_member_role_updateChange a team member's role to viewer, editor, admin or owner.WriteUpdate Team Member Role
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.
Inputs
member_idstringrequired- Profile ID (UUID) of the team member. Example: c6822969-a5ed-81c9-8008-f4ecb0ec0600.
rolestringrequired- Team role: viewer, editor, admin or owner. One of: viewer, admin, editor, owner. Example: editor.one of
vieweradmineditorowner team_idstringrequired- ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
penpot_team_updateRename a team.WriteRename Team
Rename a team. Returns nothing on success. Use this to change a team's name.
Inputs
idstringrequired- ID (UUID) of the team. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
namestringrequired- New team name. Example: sk-test Design team 2.
penpot_webhook_createCreate a team webhook that posts Penpot events (file, comment and project changes) to a URL.WriteCreate Webhook
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.
Inputs
mtypestringrequired- Payload format: application/json or application/transit+json. One of: application/json, application/transit+json. Example: application/json.one of
application/jsonapplication/transit+json team_idstringrequired- ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
uristringrequired- HTTPS URL that receives the webhook events. Example: https://example.com/penpot-webhook.
penpot_webhook_updateUpdate a webhook's URL, payload format or active flag.WriteUpdate Webhook
Update a webhook's URL, payload format or active flag. Returns the updated webhook. Use this to pause or redirect a webhook.
Inputs
idstringrequired- ID (UUID) of the webhook. Example: c6822969-a5ed-81c9-8008-f4ecb0bb0001.
is_activebooleanrequired- true to enable the webhook, false to pause it. Example: true.
mtypestringrequired- Payload format: application/json or application/transit+json. One of: application/json, application/transit+json. Example: application/json.one of
application/jsonapplication/transit+json uristringrequired- HTTPS URL that receives the webhook events. Example: https://example.com/penpot-webhook.
penpot_comment_deleteDelete one comment.DestructiveDelete Comment
Delete one comment. Returns nothing on success. Use penpot_comment_thread_delete to remove a whole thread.
Inputs
idstringrequired- ID (UUID) of the comment. Example: c6822969-a5ed-81c9-8008-f4ecb2349800.
share_idstring- Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.
penpot_comment_thread_deleteDelete a comment thread with all its comments.DestructiveDelete Comment Thread
Delete a comment thread with all its comments. Returns nothing on success. Use penpot_comment_thread_resolve to close it instead.
Inputs
idstringrequired- ID (UUID) of the comment thread. Example: c6822969-a5ed-81c9-8008-f4ecb2349795.
share_idstring- Share link ID (UUID), only when acting through a share link. Example: c6822969-a5ed-81c9-8008-f4ecb0d346f9.
penpot_file_deleteDelete a file; Penpot keeps it recoverable for a while.DestructiveDelete File
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.
Inputs
idstringrequired- ID (UUID) of the file. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
penpot_file_library_unlinkUnlink a shared library from a file.DestructiveUnlink Library from File
Unlink a shared library from a file. Returns nothing on success. Use this to remove a design system dependency.
Inputs
file_idstringrequired- ID (UUID) of the file. Find it with penpot_project_files_list or penpot_files_search. Example: c6822969-a5ed-81c9-8008-f4ecb1300e80.
library_idstringrequired- ID (UUID) of the shared library file. Example: c6822969-a5ed-81c9-8008-f4ecb2414493.
penpot_file_snapshot_deleteDelete a saved version (snapshot) of a file.DestructiveDelete File Version
Delete a saved version (snapshot) of a file. Returns nothing on success. Use this to remove an outdated version.
Inputs
idstringrequired- ID (UUID) of the version (snapshot). Example: c6822969-a5ed-81c9-8008-f4ecb0aa0001.
penpot_project_deleteDelete a project and all its files; Penpot keeps deleted files recoverable for a while.DestructiveDelete Project
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.
Inputs
idstringrequired- ID (UUID) of the project. Example: c6822969-a5ed-81c9-8008-f4ecb0dde99d.
penpot_team_deleteDelete a team with all its projects and files.DestructiveDelete Team
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.
Inputs
idstringrequired- ID (UUID) of the team. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
penpot_team_invitation_deleteCancel a pending invitation to a team by email.DestructiveDelete Team Invitation
Cancel a pending invitation to a team by email. Returns nothing on success. Use this to withdraw an invitation.
Inputs
emailstringrequired- Email address of the invitation. Example: jane@example.com.
team_idstringrequired- ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
penpot_team_member_deleteRemove a member from a team.DestructiveRemove Team Member
Remove a member from a team. Returns nothing on success. Use this to revoke someone's access to a team.
Inputs
member_idstringrequired- Profile ID (UUID) of the team member. Example: c6822969-a5ed-81c9-8008-f4ecb0ec0600.
team_idstringrequired- ID (UUID) of the team. Find it with penpot_teams_list. Example: c6822969-a5ed-81c9-8008-f4ecb0ec051b.
penpot_webhook_deleteDelete a team webhook.DestructiveDelete Webhook
Delete a team webhook. Returns nothing on success. Use penpot_webhook_update with is_active false to pause it instead.
Inputs
idstringrequired- ID (UUID) of the webhook. Example: c6822969-a5ed-81c9-8008-f4ecb0bb0001.
No tools match.