ManagedFolder: delete

Delete a managed folder within a bucket.

Required permissions

The authenticated user must have the storage.managedfolders.delete IAM permission to use this method. To use allowNonEmpty, the user must also have the storage.managedFolders.setIamPolicy permission.


HTTP request


In addition to standard query parameters, the following parameters apply to this method.

To see an example of how to include query parameters in a request, see the JSON API Overview page.


Parameter name Value Description
Path parameters
bucket string The parent bucket of the managed folder.
managedFolder string The name of the managed folder, expressed as a path. For example, example-dir. If the managed folder is nested (for example, example-dir1/example-dir2), the / character in the managed folder path must be escaped. For example, example-dir1%2Fexample-dir2.
Optional query parameters
allowNonEmpty boolean Allows the deletion of a managed folder even if it's not empty. A managed folder is not empty if it contains objects or other managed folders. If a non-empty managed folder is deleted, a simulated folder with the same name is retained.

Request body

Do not supply a request body with this method.


If successful, this method returns an empty response body.