KEkernel
Browser Pools

Release a browser back to the pool

Release a browser back to the pool, optionally recreating the browser instance.

post/browser_pools/{id_or_name}/release

Request

  • Base URL
    https://api.onkernel.com
  • URL
    https://api.onkernel.com/browser_pools/{id_or_name}/release
  • Auth
    HTTP bearer

Path parameters

id_or_namestring required

Browser pool ID or name

Request body

reuseboolean

Whether to reuse the browser instance or destroy it and create a new one. Defaults to true. A reused browser keeps the configuration it was created with, so it does not pick up pool configuration changes made while it was in use. Release with reuse: false, or flush the pool afterward, to rebuild it with the current configuration. Browsers loaded with an acquire-time profile are always destroyed and replaced, even when reuse is true.

session_idstring required

Browser session ID to release back to the pool

Example request

{
  "session_id": "ts8iy3sg25ibheguyni2lg9t"
}

Response

Browser released successfully

Changes

No recorded changes to this operation across all 123 revisions of this API.