Environment operations

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

Updated
OperationWhat it doesPermissionConfirmation
environment.readenvironment.read with validated settings and revisioned undo.site.readnone
environment.updateenvironment.update with validated settings and revisioned undo.site.adminnone

environment.read

environment.read with validated settings and revisioned undo.

permission: site.readreads onlyclass: read

Example input

{}

Input

The input is a record; see the schema below.

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

Output

FieldTypeRequiredNotes
variablesrecord of nullyes

Try it

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

environment.update

environment.update with validated settings and revisioned undo.

permission: site.adminwrites: environmentclass: transactionundo: yes

Example input

{
  "variables": {
    "NEWSLETTER_LIST_ID": "list-42"
  }
}

Input

FieldTypeRequiredNotes
variablesrecord of string | nullyes

Output

FieldTypeRequiredNotes
variablesrecord of nullyes

Try it

yarn splash environment.update '{"variables":{"NEWSLETTER_LIST_ID":"list-42"}}' --dry-run

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

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