Delete environments Stay organized with collections Save and categorize content based on your preferences.
You are currently viewing version 1.5 of the Apigee hybrid documentation.This version is end of life. You should upgrade to a newer version. For more information, seeSupported versions.
This topic explains how to delete environments in Apigee hybrid. See alsoAbout environments and environment groups.
How to delete an environment
Assume that you have two environments,test andprod. In your overrides file, the definitions might look something like this:
...envs: - name: test serviceAccountPaths: synchronizer: "your_keypath/synchronizer-manager-service-account.json udca: "your_keypath/analytic-agent-service-account.json - name: prod serviceAccountPaths: synchronizer: "your_keypath/synchronizer-manager-service-account.json udca: "your_keypath/analytic-agent-service-account.json...
To delete theprod environment, follow these steps:
- Get your gcloud authentication credentials:
TOKEN=$(gcloud auth print-access-token)
- Delete the environment from any associated environment groups, one at a time:
curl -X DELETE -H "Authorization: Bearer$TOKEN" \ "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/envgroups/$ENV_GROUP/attachments/prod
- Do a dry run to test removal of the runtime components:
apigeectl delete -f overrides.yaml --env=prod --dry-run=true
- If the dry run is error-free, remove the runtime components:
apigeectl delete -f overrides.yaml --env=prod
- Delete the environment from the management plane:
curl -X DELETE -H "Authorization: Bearer$TOKEN" \ "https://apigee.googleapis.com/v1/organizations/$ORG_NAME/environments/prod
- Open your overrides file and remove the
testenvironment definition fromenvsandvirtualhosts, leaving only theprod definitions. For example:...envs: - name: prod serviceAccountPaths: synchronizer: "your_keypath/synchronizer-manager-service-account.json udca: "your_keypath/analytic-agent-service-account.json...
- Save the file.
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-02-19 UTC.