Maintenance operations

2 operations named maintenance.*. Every one runs in a batch through apply_ops, dry_run_ops, the CLI or the admin.

Updated
OperationWhat it doesPermissionConfirmation
maintenance.migratemaintenance.migrate in one transaction; recovery uses an explicit backup restore.site.admindestructive
maintenance.restoreBackupmaintenance.restoreBackup in one transaction; recovery uses an explicit backup restore.site.admindestructive

maintenance.migrate

maintenance.migrate in one transaction; recovery uses an explicit backup restore.

permission: site.adminwrites: pages, siteclass: transactionconfirm: destructiveundo: explicit recovery

Example input

{}

Input

The input is a record; see the schema below.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Output

FieldTypeRequiredNotes
autorecord of any JSON | nullyes

Needs confirmed: ["destructive"] on the batch, which the single-operation CLI form does not set: put it in a batch file and run yarn splash apply <file> --dry-run.

maintenance.restoreBackup

maintenance.restoreBackup in one transaction; recovery uses an explicit backup restore.

permission: site.adminwrites: pages, siteclass: transactionconfirm: destructiveundo: explicit recovery

Example input

{
  "backupId": "backup-2026-10-16"
}

Input

FieldTypeRequiredNotes
backupIdstringyesAt least 1 character.

Output

FieldTypeRequiredNotes
successtrueyes
restoredCountintegeryesAt least 0.
pageCountintegeryesAt least 0.

Needs confirmed: ["destructive"] on the batch, which the single-operation CLI form does not set: put it in a batch file and run yarn splash apply <file> --dry-run.

Generated from the operation registry and the MCP tool catalogue (source 833d278a47e09971).

Something wrong on this page? Write to docs@librettocms.com.

Libretto docs

Colophon. These docs are a Libretto site: 68 pages in two languages, 20 guide pages imported from Markdown and 41 reference pages generated from the operation registry. Set in Softcore, with code in IBM Plex Mono. Its outline:

/ Libretto docs /start Get started /start/request-access Request access /start/workspace Your workspace /start/first-site Your first site /start/invite-a-client Invite a client /start/connect-claude Connect Claude to Libretto /build Build /build/first-page Build a page /build/layers-and-canvas Layers and canvas /build/site-components Site components /design-system Design system /design-system/tokens Colours, space and themes /design-system/components Components and variants /design-system/fonts Typography and fonts /motion Motion /motion/scenes Scenes and recipes /motion/image-sequences Image sequences /motion/reduced-motion Reduced motion /publish Publish /publish/languages Site languages /publish/versions Publish and versions /publish/members-and-forms Members and forms /publish/domains Domains /handover Hand a site to a client /glossary Glossary /agents Agents and API /agents/mcp MCP server /agents/cli CLI /agents/batches Batches /agents/errors Errors and findings /agents/operations Operations /search Search