Skip to main content
Manage environments from the command line. Create and configure deployment stages for your monitors.

Commands

CommandDescription
devhelm environments listList all environments
devhelm environments get <slug>Get environment details
devhelm environments createCreate an environment
devhelm environments update <slug>Update an environment
devhelm environments delete <slug>Delete an environment
Environments are identified by slug (e.g., production, staging), not numeric ID.

environments list

devhelm environments list
FlagTypeDefaultDescription
--page-sizeinteger200Number of items per API request (1–200)

environments get

devhelm environments get production

environments create

devhelm environments create --name "Production" --slug production --default
FlagTypeRequiredDescription
--namestringYesHuman-readable environment name
--slugstringYesURL-safe identifier (lowercase, hyphens)
--default / --no-defaultbooleanfalseMark this environment as the workspace default (exactly one allowed)

environments update

devhelm environments update staging --name "Staging (US)" --no-default
FlagTypeDescription
--namestringNew environment name
--default / --no-defaultbooleanPromote/demote default environment status

environments delete

Prompts for confirmation; pass --yes (-y) in scripts and CI.
devhelm environments delete staging

Next steps

Secrets

Scope secrets to specific environments.

Multi-environment config

Manage per-environment YAML files.