> ## 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).

## Parameters

| 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. For organizations and folders, must be the numeric ID. For projects, can be the alphanumeric or numeric ID. 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`. |

## 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)

![Workflow Library](https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max\&auto=format\&n=ojHYuDeYX5FWuN8a\&q=85\&s=b8af968e71438a9499c3223c9bd29fb2)

Preview this Workflow on desktop

[https://library.blinkops.com/workflows/update-iam-policy-with-gcp-and-send-results-via-email/canvas](https://library.blinkops.com/workflows/update-iam-policy-with-gcp-and-send-results-via-email/canvas)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.