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 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 and projects.list methods.

The caller must have delete permissions for this Project.

HTTP request

DELETE https://cloudresourcemanager.googleapis.com/v1/projects/{projectId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
projectId

string

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

Required.

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

  • resourcemanager.projects.delete

Request body

The request body must be empty.

Response body

If successful, the response body is an empty JSON object.

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.