Authorization: Token <token> and asks for plain JSON with Accept: application/json (without that header Penpot answers in transit format). Every operation is a single RPC: a POST to /api/rpc/command/<name> on design.penpot.app. Self-hosted instances are not supported yet.
Penpot documents request schemas only, so output objects are kept loose; ids are UUIDs. The API reference lives at https://design.penpot.app/api/_doc (auto-generated from source).
Webhook deliveries from Penpot carry no signature: Penpot posts the audit event itself ({ id, name, type, props, profileId }, with a penpot/<version> User-Agent). The plugin accepts deliveries on that shape; add your own check at the route if you need stronger guarantees.
The RPC surface has ~150 operations; this plugin covers the teams, projects, files (including snapshots and share links), comments, webhooks and access-token groups. Fonts, media objects, invitations, members, organizations and exports are documented by Penpot but not part of this plugin.
What you get:
- 31 typed API operations
- 1 incoming webhook event types
Setup
1
Install
2
Add the plugin
corsair.ts
multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.3
Choose authentication
- API Key (Recommended)
Store the Penpot API key before the first call: More: API Key
pnpm corsair setup --plugin=penpot --tenant=acme api_key=<your-key> (leave out --tenant without multiTenancy), or pass it as key in the plugin options. With Hub, each tenant enters their own key on the connect page. See API key auth.4
Connect a tenant
Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.
Example API calls
List all projectsWebhooks
This plugin registers 1 webhook event type. Configure the provider to POST to your Corsair HTTP handler, then usewebhookHooks on the plugin factory.
See Webhooks for every event path and payload shape, and Webhooks concept for routing.
What’s next
API reference
Every
penpot.api.* operation with input and output types.Webhooks
Event paths, payloads, and
webhookHooks examples.Connect / OAuth
createLink, Hub delivery, and tenant connect flows.
Use with agents
Expose this plugin’s operations as MCP tools.