Method: folders.delete

Requests deletion of a Folder. The Folder is moved into the DELETE_REQUESTED state immediately, and is deleted approximately 30 days later. This method may only be called on an empty Folder in the ACTIVE state, where a Folder is empty if it doesn't contain any Folders or Projects in the ACTIVE state. The caller must have resourcemanager.folders.delete permission on the identified folder.

HTTP request

DELETE https://cloudresourcemanager.googleapis.com/v2/{name=folders/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. the resource name of the Folder to be deleted. Must be of the form folders/{folder_id}.

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

  • resourcemanager.folders.delete

Request body

The request body must be empty.

Response body

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

Authorization scopes

Requires one of the following OAuth scopes:

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

For more information, see the Authentication Overview.