API configuration operations

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

Updated
OperationWhat it doesPermissionConfirmation
apiConfig.readapiConfig.read with validated settings and revisioned undo.site.readnone
apiConfig.updateapiConfig.update with validated settings and revisioned undo.site.adminnone

apiConfig.read

apiConfig.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
configobject | nullyes

Try it

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

apiConfig.update

apiConfig.update with validated settings and revisioned undo.

permission: site.adminwrites: apiConfigclass: transactionundo: yes

Example input

{
  "headers": [],
  "sources": [],
  "requests": [
    {
      "id": "feed",
      "name": "Feed",
      "method": "GET",
      "endpoint": "/feed"
    }
  ]
}

Input

FieldTypeRequiredNotes
baseUrlstringno
headersarray of objectyes
headers[].keystringyes
headers[].valuestringyes
headers[].typestringno
headers[].sourcestring | nullno
sourcesarray of objectnoDefault [].
sources[].idstringyes
sources[].namestringyes
sources[].baseUrlstringyes
sources[].colorstring | nullno
requestsarray of objectyes
requests[].idstringyes
requests[].namestringyes
requests[].methodstringyes
requests[].endpointstringyes
requests[].sourceIdstring | nullno
requests[].bodyrecord of any JSONno
requests[].contractrecord of stringno

Output

FieldTypeRequiredNotes
configobject | nullyes

Try it

yarn splash apiConfig.update '{"headers":[],"sources":[],"requests":[{"id":"feed","name":"Feed","method":"GET","endpoint":"/feed"}]}' --dry-run

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

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