Manage environments

Add, rename, recolour, reorder and delete the environments secrets are kept in.

Last updated 18 November 2026View as Markdown

Replace qa with the environment's slug and 7c6d5e4f-3a2b-4c1d-9e8f-7a6b5c4d3e2f with its id.

Prerequisites

  • Permission for secrets:CreateSecretEnvironment to add, secrets:UpdateSecretEnvironment to change, secrets:DeleteSecretEnvironment to delete. In the console, also secrets:ListSecretEnvironments to open Environments; without it the page says your policies do not grant it.
  • A free unit of the environments quota to add one; see Quotas.

Add an environment

  1. Open Environments (in the Secrets navigation), and choose Manage environments.
  2. Choose Add environment.
  3. For Name, enter QA.
  4. For Slug, enter qa. It cannot be changed later.
  5. (Optional) Under Colour, choose a colour, or keep Automatic.
  6. Choose Add environment.

The console adds it last in the promotion order.

The slug is lower-case letters, digits and hyphens, at most 63 characters, and unique in the organization. Without position, it goes after the last environment (its position plus 10).

Rename, recolour or reorder

  1. In Manage environments, choose the pencil beside the environment.
  2. Change Name or Colour.
  3. Choose Save.

The console does not change the order; use the CLI, the API or Terraform.

Delete an environment

In Manage environments, choose the bin beside the environment. It is shown only for an environment with no secrets and no apps, and deletes at once.

Refusals

  • 409 "An environment qa already exists".
  • 409 "QA still holds 2 secret(s) and 1 app(s). Move or delete them first".
  • 409 when the environments quota is full.
Did this page help you?