Access operations

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

Updated
OperationWhat it doesPermissionConfirmation
access.readRead your own design-system levels on this site: the level of each area (palette, components, variants, themes, ...) and the role overrides that set them.site.readnone
access.updateaccess.update with validated settings and revisioned undo.site.adminnone

access.read

Read your own design-system levels on this site: the level of each area (palette, components, variants, themes, ...) and the role overrides that set them. A designSystem.* operation is refused unless your level in its area allows it.

permission: site.readreads onlyclass: read

Example input

{}

Input

The input is a record; see the schema below.

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

Output

FieldTypeRequiredNotes
rolestringyesOne of "admin", "editor", "viewer", "client", "content".
levelsrecord of stringyes
overridesarray of objectyes
overrides[].rolestringyesOne of "editor", "client".
overrides[].areastringyesOne of "palette", "semantic-colours", "font-families", "type-presets", "space", "radius", "borders", "shadow", "motion", "grid", "assets", "components", "variants", "themes", "import-export", "reset".
overrides[].levelstringyesOne of "none", "view", "edit", "pick", "switch-default", "export", "own-areas".

Try it

yarn splash access.read '{}' --dry-run

access.update

access.update with validated settings and revisioned undo.

permission: site.adminwrites: accessclass: transactionundo: yes

Example input

{
  "role": "editor",
  "area": "palette",
  "level": "view"
}

Input

FieldTypeRequiredNotes
rolestringyesOne of "editor", "client".
areastringyesOne of "palette", "semantic-colours", "font-families", "type-presets", "space", "radius", "borders", "shadow", "motion", "grid", "assets", "components", "variants", "themes", "import-export", "reset".
levelstringyesOne of "none", "view", "edit", "pick", "switch-default", "export", "own-areas".

Output

FieldTypeRequiredNotes
rolestringyesOne of "admin", "editor", "viewer", "client", "content".
levelsrecord of stringyes
overridesarray of objectyes
overrides[].rolestringyesOne of "editor", "client".
overrides[].areastringyesOne of "palette", "semantic-colours", "font-families", "type-presets", "space", "radius", "borders", "shadow", "motion", "grid", "assets", "components", "variants", "themes", "import-export", "reset".
overrides[].levelstringyesOne of "none", "view", "edit", "pick", "switch-default", "export", "own-areas".

Try it

yarn splash access.update '{"role":"editor","area":"palette","level":"view"}' --dry-run

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

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