---
title: "Delete a browser pool"
method: DELETE
path: "/browser_pools/{id_or_name}"
tags: ["Browser Pools"]
---

# Delete a browser pool

`DELETE /browser_pools/{id_or_name}`

Delete a browser pool and all browsers in it. By default, deletion is blocked if browsers are currently leased. Use force=true to terminate leased browsers.

## Path parameters

- `id_or_name` string, required

## Request body

- BrowserPoolDeleteRequest — Parameters for deleting a browser pool.
  - `force` boolean — If true, force delete even if browsers are currently leased. Leased browsers will be terminated.

## Response `204`

Browser pool deleted 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)