Deploy JSON Configs with Reis (Flag Mode)

Use the Reis CLI to manage JSON configuration files using command-line flags.

Updated 23 Jun 20261 min read

Use the Reis CLI to manage JSON configuration files using command-line flags.

Create a JSON config

reis json_config:create \
  --org <organisation-id> \
  --name "App Settings" \
  --handle app-settings \
  --content_file ./config/app-settings.json

List JSON configs

reis json_config:list --org <organisation-id>

Show a JSON config

reis json_config:show <config-id> --org <organisation-id>

Rotate (update content)

reis json_config:rotate <config-id> \
  --org <organisation-id> \
  --content_file ./config/app-settings-v2.json

List versions

reis json_config:versions <config-id> --org <organisation-id>

Activate a previous version

reis json_config:activate_version <config-id> <version-number> --org <organisation-id>

Delete a JSON config

reis json_config:delete <config-id> --org <organisation-id>

Add --force to skip the confirmation prompt.

Required flags for create

Flag	Description
`--name`	Human-readable display name
`--handle`	DNS-1123-compliant identifier (auto-generated from name if omitted)
`--content_file`	Path to a file containing valid JSON content

Attach to a project

reis project:attach <project-id> json_configs app-config

Singular alias json_config is also accepted. The project-id is the UUID Reis returns from project:list or project:show.

Detach from a project

reis project:detach <project-id> json_configs app-config

If a running container still mounts the config, detach is rejected with a 409 naming the blocking container — tear it down (or remove its json_configs block) and retry.