Method: projects.delete

Marks the project identified by the specified name (for example, projects/415104041262) for deletion.

This method will only affect the project if it 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, projects.list, and projects.search methods.

This method behaves idempotently, such that deleting a DELETE_REQUESTED project will not cause an error, but also won't do anything.

The caller must have resourcemanager.projects.delete permissions for this project.

HTTP request

DELETE https://cloudresourcemanager.googleapis.com/v3/{name=projects/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The name of the Project (for example, projects/415104041262).

Authorization requires the following IAM permission on the specified resource name:

  • resourcemanager.projects.delete

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of Operation.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloudplatformprojects

For more information, see the Authentication Overview.