dyn settings.
What you need: The CLI installed and authenticated, with an environment selected. See Getting started.
dyn settings reads and writes the active environment — confirm it with dyn status first.Discover settings
dyn settings list is the canonical discovery surface — every path with its description. Use it instead of guessing paths:
Read a value
Write a value
dyn settings set performs a read-modify-write on a single leaf — it changes only the path you name and leaves the rest of the tree untouched:
Collections live outside the settings tree
The settings tree holds scalar and object configuration. Collections — lists of records you add, remove, or toggle — are managed through their own resource commands, notdyn settings. Each resource is a command group with its own actions:
dyn providers …, not settings.providers. The actions a resource supports vary by what the API allows — run dyn <resource> --help to see them:
dyn providers— full lifecycle:create,get,update,delete, plusenable/disable.dyn exchanges—create,get,delete, andenable/disable. There is no in-placeupdate; change an exchange by toggling it or recreating it.dyn custom-networks—create,get,update,delete. These are defined at the organization level, so they are shared across the org’s environments rather than scoped to a single environment.
Most environment-scoped collections are also managed declaratively by config as code:
dyn export / dyn apply reconcile providers, webhooks, allowlists, gates, origins, and deeplink URLs alongside the settings tree. Use the per-resource commands for a quick one-off change; use config as code to review and apply many at once. Exchanges and custom networks are not reconciled — manage them with their own commands.Single setting vs. config as code
dyn settings set— change one leaf, read-modify-write. Best for a quick, targeted change.dyn apply -f file.yaml— reconcile many fields at once from a file. The reconciler deep-merges your partial YAML onto the current state before applying. Best for multi-field changes and config you want to review in git.
Related
- Config as code — multi-field updates and safety gates.
- Managing embedded wallets — the
sdk.embeddedWalletssubtree in depth.