---
title: "Release a browser back to the pool"
method: POST
path: "/browser_pools/{id_or_name}/release"
tags: ["Browser Pools"]
---

# Release a browser back to the pool

`POST /browser_pools/{id_or_name}/release`

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

## Path parameters

- `id_or_name` string, required

## Request body

- BrowserPoolReleaseRequest — Request body for releasing a browser back to the pool.
  - `session_id` string, required — Browser session ID to release back to the pool
  - `reuse` boolean — 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.

## Response `204`

Browser released successfully

## Other responses

- `400` — Bad Request – invalid input
- `401` — Unauthorized – missing or invalid authorization token
- `403` — Forbidden – insufficient permissions or plan
- `404` — Resource not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/kernel/apis/kernel-api.md) · [All operations](https://skmtc.net/kernel/apis/kernel-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kernel/kernel-api/versions/9e8ce9fcf5e1/schema)