- NAME
-
- gcloud beta projects delete - delete a project
- SYNOPSIS
-
-
gcloud beta projects deletePROJECT_ID_OR_NUMBER[--recommend=BOOLEAN_VALUE] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)Deletes the project with the given project ID.This command can fail for the following reasons:
- The project specified does not exist.
- The active account does not have IAM role
role/owneror another IAM role with theresourcemanager.projects.deletepermission for the given project.
See Access control for projects using IAM for more information.
- EXAMPLES
- The following command deletes the project with the ID
example-foo-bar-1:gcloud beta projects delete example-foo-bar-1 - POSITIONAL ARGUMENTS
-
-
PROJECT_ID_OR_NUMBER - ID or number for the project you want to delete.
-
- FLAGS
-
-
--recommend=BOOLEAN_VALUE - If true, checks Active Assist recommendation for the risk level of project deletion, and issues a warning in the prompt. Optional flag is set to false by default. For details see https://cloud.google.com/recommender/docs/change-risk-recommendations
-
- GCLOUD WIDE FLAGS
- These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$ gcloud helpfor details. - SEE ALSO
- See https://support.google.com/cloud/answer/6251787 for information on creating or deleting projects from the Google Cloud Platform Console.
- NOTES
- This command is currently in beta and might change without notice. These
variants are also available:
gcloud projects deletegcloud alpha projects delete
gcloud beta projects delete
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.
