Method: folders.undelete

Cancels the deletion request for a Folder. This method may only be called on a Folder in the DELETE_REQUESTED state. In order to succeed, the Folder's parent must be in the ACTIVE state. In addition, reintroducing the folder into the tree must not violate folder naming, height and fanout constraints described in the folders.create documentation. The caller must have resourcemanager.folders.undelete permission on the identified folder.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



The resource name of the Folder to undelete. Must be of the form folders/{folder_id}.

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

  • resourcemanager.folders.undelete

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:


For more information, see the Authentication Overview.