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, specifically using the \u003ccode\u003epolicyBinding.name\u003c/code\u003e path parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003evalidateOnly\u003c/code\u003e and \u003ccode\u003eupdateMask\u003c/code\u003e query parameters allow for request validation and specifying which fields to update, respectively.\u003c/p\u003e\n"],["\u003cp\u003eUpdating a policy binding requires appropriate IAM permissions, including those to modify the policy and remove existing bindings.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be a \u003ccode\u003ePolicyBinding\u003c/code\u003e object, and a successful response will contain an \u003ccode\u003eOperation\u003c/code\u003e object, representing a long-running process.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this operation requires the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: organizations.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/v3beta/{policyBinding.name=organizations/*/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/v3beta/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)."]]
