Moves a folder under a new resource parent. Returns anOperationwhich can be used to track the progress of the folder move workflow. Upon success, theOperation.responsefield will be populated with the moved folder. Upon failure, aFolderOperationErrorcategorizing the failure cause will be returned - if the failure occurs synchronously then theFolderOperationErrorwill be returned in theStatus.detailsfield. If it occurs asynchronously, then the FolderOperation will be returned in theOperation.errorfield. In addition, theOperation.metadatafield will be populated with aFolderOperationmessage as an aid to stateless clients. Folder moves will be rejected if they violate either the naming, height, or fanout constraints described in thefolders.createdocumentation. The caller must haveresourcemanager.folders.movepermission on the folder's current and proposed new parent.
HTTP request
POST https://cloudresourcemanager.googleapis.com/v3/{name=folders/*}:move
Required. The resource name of the Folder to move. Must be of the form folders/{folder_id}
Request body
The request body contains data with the following structure:
JSON representation
{"destinationParent":string}
Fields
destinationParent
string
Required. The resource name of the folder or organization which should be the folder's new parent. Must be of the formfolders/{folder_id}ororganizations/{org_id}.
Response body
If successful, the response body contains an instance ofOperation.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-11 UTC."],[],[],null,["# Method: folders.move\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nMoves a folder under a new resource parent. Returns an `Operation` which can be used to track the progress of the folder move workflow. Upon success, the `Operation.response` field will be populated with the moved folder. Upon failure, a `FolderOperationError` categorizing the failure cause will be returned - if the failure occurs synchronously then the `FolderOperationError` will be returned in the `Status.details` field. If it occurs asynchronously, then the FolderOperation will be returned in the `Operation.error` field. In addition, the `Operation.metadata` field will be populated with a `FolderOperation` message as an aid to stateless clients. Folder moves will be rejected if they violate either the naming, height, or fanout constraints described in the [folders.create](/resource-manager/reference/rest/v3/folders/create#google.cloud.resourcemanager.v3.Folders.CreateFolder) documentation. The caller must have `resourcemanager.folders.move` permission on the folder's current and proposed new parent.\n\n### HTTP request\n\n`POST https://cloudresourcemanager.googleapis.com/v3/{name=folders/*}:move`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/resource-manager/reference/rest/Shared.Types/Operation).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `https://www.googleapis.com/auth/cloudplatformfolders`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
