Update a browser pool
Updates the configuration used to create browsers in the pool.
As with creation, save_changes on the pool profile is ignored (not rejected); pooled
browsers never persist changes back to the profile.
To clear the profile reference, send profile: { "id": "" }. Clearing the profile
also disables refresh_on_profile_update.
Authorizations
Body
Parameters for updating a browser pool. Omitted fields leave existing values unchanged.
If provided, replaces the custom Chrome enterprise policy overrides applied to all browsers in this pool. Empty object clears any previously-set policy. Keys are Chrome enterprise policy names; values must match their expected types. Blocked: kernel-managed policies (extensions, proxy, CDP/automation). See https://chromeenterprise.google/policies/ The serialized JSON payload is capped at 5 MiB.
Whether to discard all idle browsers and rebuild them immediately with the new configuration. Defaults to false. Only browsers that are idle when the update runs are rebuilt. A browser that is in use during the update keeps its original configuration, except that its allowlist is reset to the current pool baseline on release or the browser is replaced. For other configuration fields, if it is later released with reuse: true it returns to the pool with that stale configuration until it is discarded (by this flag on a later update, or by flushing the pool).
false
Optional optimistic concurrency precondition. Send the network configuration from the last pool response, or {} when it has no network configuration. The entire update is rejected with 409 stale_network if the saved network differs, checked atomically with the write. Omit for unconditional updates. Explicit empty lists differ from omitted lists; route targets must match the saved references (resolved IDs, not equivalent proxy names).
If provided, replaces the extension list. Empty array clears all previously-selected extensions. Omit this field to leave extensions unchanged.
20Extension selection for the browser session. Provide either id or name of an extension uploaded to Kernel.
- Option 1
- Option 2
If provided, replaces the pool's network configuration. Omit to leave the existing configuration unchanged; an empty object ({}) removes it, while network: {private_hosts: []} or network: {proxy_routes: []} sets an explicit empty list; allowed_hosts must be non-empty when supplied. Egress allowlists and proxy routes require proxy-v3; the pool will not provision browsers through Envoy if proxy-v3 is unavailable. Changing allowed_hosts automatically replaces idle browsers. Leased browsers retain their allowlist until release, when it is reset to the current pool baseline or the browser is replaced if it cannot safely receive that baseline. Stale browsers cannot be acquired. Other network fields only apply to browsers created after the update; existing browsers keep those fields until discarded (see discard_all_idle).
If provided, replaces whether idle browsers are flushed when the profile the pool uses is updated. When the pool's profile reference is changed (including newly attached) and this field is omitted, it defaults to true. Re-sending the same profile reference leaves this setting unchanged. Clearing the profile also disables this setting. Requires a profile to be set on the pool.
true
If provided, updates the pool's telemetry configuration. Omit, set to null, or set to an empty object ({}) to leave the existing configuration unchanged. Set enabled to true to enable capture using the default set. Set enabled to false to clear the pool's telemetry. Provide browser category settings for per-category updates, merged onto the pool's current configuration. Only applied to browsers warmed after the update; browsers already in the pool keep their configuration until discarded.
Response
Browser pool details
A browser pool containing multiple identically configured browsers.