---
title: "PATCH /browserSettings/{browserSettingsArn}"
method: PATCH
path: "/browserSettings/{browserSettingsArn}"
---

# PATCH /browserSettings/{browserSettingsArn}

`PATCH /browserSettings/{browserSettingsArn}`

Updates browser settings.

## Path parameters

- `browserSettingsArn` string, required

## Request body

- object
  - `browserPolicy` string, password — A JSON string containing Chrome Enterprise policies that will be applied to all streaming sessions.
  - `clientToken` string — <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. Idempotency ensures that an API request completes only once. With an idempotent request, if the original request completes successfully, subsequent retries with the same client token return the result from the original successful request. </p> <p>If you do not specify a client token, one is automatically generated by the Amazon Web Services SDK.</p>
  - `webContentFilteringPolicy` object — The policy that specifies which URLs end users are allowed to access or which URLs or domain categories they are restricted from accessing for enhanced security.
    - `blockedCategories` Category[] — Categories of websites that are blocked on the end user’s browsers.
    - `allowedUrls` UrlPattern[] — URLs and domains that are always accessible to end users.
    - `blockedUrls` UrlPattern[] — URLs and domains that end users cannot access.

## Response `200`

Success

- UpdateBrowserSettingsResponse
  - `browserSettings` object, required — The browser settings.
    - `browserSettingsArn` string, required — The ARN of the browser settings.
    - `associatedPortalArns` ARN[] — A list of web portal ARNs that this browser settings is associated with.
    - `browserPolicy` string, password — A JSON string containing Chrome Enterprise policies that will be applied to all streaming sessions.
    - `customerManagedKey` string — The customer managed key used to encrypt sensitive information in the browser settings.
    - `additionalEncryptionContext` object — The additional encryption context of the browser settings.
    - `webContentFilteringPolicy` object — The policy that specifies which URLs end users are allowed to access or which URLs or domain categories they are restricted from accessing for enhanced security.
      - `blockedCategories` Category[] — Categories of websites that are blocked on the end user’s browsers.
      - `allowedUrls` UrlPattern[] — URLs and domains that are always accessible to end users.
      - `blockedUrls` UrlPattern[] — URLs and domains that end users cannot access.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — AccessDeniedException
- `483` — ThrottlingException
- `484` — ValidationException

---

[API](https://skmtc.net/aws/apis/workspaces-web.md) · [All operations](https://skmtc.net/aws/apis/workspaces-web/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/workspaces-web/versions/4206b0208021/schema)