penpot_checkpoint
Creates a snapshot of shapes to enable undo of subsequent changes, including irreversible deletions. Specify a page or omit for whole-file checkpoint.
Instructions
Snapshot shapes so a subsequent penpot_restore_checkpoint call can undo whatever happens between now and then — including a wrong penpot_delete_shapes call, which otherwise has no undo path short of Penpot's own UI. When pageId is supplied only that page is snapshotted; omit pageId to snapshot every page in the file (whole-file checkpoint). Reusable across multiple restores until explicitly discarded via penpot_discard_checkpoint. When the server is configured with PENPOT_CHECKPOINTS_PATH the checkpoint is also written to disk and will survive a server restart; without that setting it lives only in process memory and is lost on restart. Call this immediately before a risky multi-step edit; pass the returned checkpointId to penpot_restore_checkpoint to undo everything since.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"fileId": "<fileId>"
},
"name": "penpot_checkpoint"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fileId | Yes | ||
| pageId | No |