> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update IAM Policy

Updates the specified policy. You can update only the rules and the display name for the policy. To update a policy, you should use a read-modify-write loop: 1. Use GetPolicy to read the current version of the policy. 2. Modify the policy as needed. 3. Use `UpdatePolicy` to write the updated policy. This pattern helps prevent conflicts between concurrent updates.

<Note>
  External Documentation

  To learn more, visit the [GCP documentation](https://cloud.google.com/iam/docs/reference/rest/v2beta/policies/update).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter    | Description                                                                                                                                                                                                                  |
  | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Annotations  | A key-value map to store arbitrary metadata for the `Policy`. Keys can be up to 63 characters. Values can be up to 255 characters.                                                                                           |
  | Display Name | A user-specified description of the `Policy`. This value can be up to 63 characters.                                                                                                                                         |
  | Parent ID    | The ID of the parent resource to access.<br /><br />For organizations and folders, must be the numeric ID.<br />For projects, can be the alphanumeric or numeric ID.<br /><br />All action responses contain the numeric ID. |
  | Parent Type  | Which type of parent resource to access.                                                                                                                                                                                     |
  | Policy ID    | Name of the policy to access. Can be retrieved using the "List IAM Policies" action.                                                                                                                                         |
  | Rules        | A list of rules that specify the behavior of the `Policy`. All of the rules should be of the `kind` specified in the `Policy`.                                                                                               |
</div>

## Example Output

```json theme={"dark"}
{
	"done": false,
	"error": {
		"code": 0,
		"details": [
			{}
		],
		"message": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client."
	},
	"metadata": {},
	"name": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.",
	"response": {}
}
```

## Workflow Library Example

[Update Iam Policy with Gcp and Send Results Via Email](https://library.blinkops.com/workflows/update-iam-policy-with-gcp-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/update-iam-policy-with-gcp-and-send-results-via-email/canvas" />
</div>