Updates a folder, changing its displayName. Changes to the folder displayName will be rejected if they violate either the displayName formatting rules or the naming constraints described in the folders.create documentation.
The folder's displayName must start and end with a letter or digit, may contain letters, digits, spaces, hyphens and underscores and can be between 3 and 30 characters. This is captured by the regular expression: [\p{L}\p{N}][\p{L}\p{N}_- ]{1,28}[\p{L}\p{N}]. The caller must have resourcemanager.folders.update permission on the identified folder.
If the update fails due to the unique name constraint then a PreconditionFailure explaining this violation will be returned in the Status.details field.
[[["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.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates a folder, changing its `displayName`. Changes to the folder `displayName` will be rejected if they violate either the `displayName` formatting rules or the naming constraints described in the [folders.create](/resource-manager/reference/rest/v3/folders/create#google.cloud.resourcemanager.v3.Folders.CreateFolder) documentation.\n\nThe folder's `displayName` must start and end with a letter or digit, may contain letters, digits, spaces, hyphens and underscores and can be between 3 and 30 characters. This is captured by the regular expression: `[\\p{L}\\p{N}][\\p{L}\\p{N}_- ]{1,28}[\\p{L}\\p{N}]`. The caller must have `resourcemanager.folders.update` permission on the identified folder.\n\nIf the update fails due to the unique name constraint then a `PreconditionFailure` explaining this violation will be returned in the Status.details field.\n\n### HTTP request\n\n`PATCH https://cloudresourcemanager.googleapis.com/v3/{folder.name=folders/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [Folder](/resource-manager/reference/rest/v3/folders#Folder).\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)."]]