Method: projects.delete

Marks the Project identified by the specified projectId (for example, my-project-123) for deletion. This method will only affect the Project if the following criteria are met:

  • The Project does not have a billing account associated with it.
  • The Project has a lifecycle state of ACTIVE.

This method changes the Project's lifecycle state from ACTIVE to DELETE_REQUESTED. The deletion starts at an unspecified time, at which point the Project is no longer accessible.

Until the deletion completes, you can check the lifecycle state checked by retrieving the Project with projects.get, and the Project remains visible to projects.list. However, you cannot update the project.

After the deletion completes, the Project is not retrievable by the projects.get and projects.list methods.

The caller must have modify permissions for this Project.

HTTP request


The URL uses Google API HTTP annotation syntax.

Path parameters



The Project ID (for example, foo-bar-123).


Authorization requires the following Google IAM permission on the specified resource project_id:

  • resourcemanager.projects.delete

Request body

The request body must be empty.

Response body

If successful, the response body will be empty.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Auth Guide.

Send feedback about...

Google Cloud Resource Manager
Google Cloud Resource Manager