Updates a policy binding and returns a long-running operation. Callers will need the IAM permissions on the policy and target in the binding to update. Target and policy are immutable and cannot be updated.
Identifier. The name of the policy binding, in the format {binding_parent/locations/{location}/policyBindings/{policyBindingId}. The binding parent is the closest Resource Manager resource (project, folder, or organization) to the binding target.
[[["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-26 UTC."],[[["\u003cp\u003eThis page details how to update a policy binding via a PATCH request to the Google Cloud IAM API.\u003c/p\u003e\n"],["\u003cp\u003eThe request URL requires specifying the \u003ccode\u003epolicyBinding.name\u003c/code\u003e path parameter, which identifies the binding to update and includes the parent resource's ID and location.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters \u003ccode\u003evalidateOnly\u003c/code\u003e and \u003ccode\u003eupdateMask\u003c/code\u003e allow for request validation and specifying the fields to be updated, respectively.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain the updated \u003ccode\u003ePolicyBinding\u003c/code\u003e resource, while a successful response will return an \u003ccode\u003eOperation\u003c/code\u003e resource.\u003c/p\u003e\n"],["\u003cp\u003eUpdating the policy binding will require you to have a permission to update the binding, as well as the permission to remove the existing policy from the binding.\u003c/p\u003e\n"]]],[],null,["# Method: folders.locations.policyBindings.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- [Examples](#examples)\n- [Try it!](#try-it)\n\nUpdates a policy binding and returns a long-running operation. Callers will need the IAM permissions on the policy and target in the binding to update. Target and policy are immutable and cannot be updated.\n\n### HTTP request\n\n`PATCH https://iam.googleapis.com/v3/{policyBinding.name=folders/*/locations/*/policyBindings/*}`\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 [PolicyBinding](/iam/docs/reference/rest/v3/folders.locations.policyBindings#PolicyBinding).\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/iam/docs/reference/rest/Shared.Types/Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
