Skip to content

Environments CLI reference

The environments command lets you manage environments for your projects.

All environments commands require --project-id.

Terminal window
hb environments list --project-id 12345

Required flags:

  • --project-id — Project ID

Optional flags:

  • -o, --output — Output format: table or json (default: table)
Terminal window
hb environments get --project-id 12345 --id 67890

Required flags:

  • --project-id — Project ID
  • --id — Environment ID

Optional flags:

  • -o, --output — Output format: text or json (default: text)
Terminal window
hb environments create --project-id 12345 --cli-input-json '{
"name": "staging",
"notifications": true
}'

Required flags:

  • --project-id — Project ID
  • --cli-input-json — JSON payload (inline string or file://path)

JSON fields:

  • name — Environment name
  • notifications — Whether to send notifications for this environment

Optional flags:

  • -o, --output — Output format: text or json (default: text)
Terminal window
hb environments update --project-id 12345 --id 67890 --cli-input-json '{"notifications": false}'

Required flags:

  • --project-id — Project ID
  • --id — Environment ID
  • --cli-input-json — JSON payload with fields to update

Optional flags:

  • -o, --output — Output format: text or json (default: text)
Terminal window
hb environments delete --project-id 12345 --id 67890

Required flags:

  • --project-id — Project ID
  • --id — Environment ID