DashboardChangelogCareersSign up
GuidesAPI ReferenceCLIMCP
POST/browser_pools/{id_or_name}/release

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

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

id_or_name*string

Browser pool ID or name

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request body for releasing a browser back to the pool.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/browser_pools/string/release" \  -H "Content-Type: application/json" \  -d '{    "session_id": "string"  }'
Empty

Acquire a browser from the pool POST

Long-polling endpoint to acquire a browser from the pool. Returns immediately when a browser is available, or returns 204 No Content when the poll times out. The client should retry the request to continue waiting for a browser. The acquired browser will use the pool's timeout_seconds for its idle timeout.

Flush all idle browsers in the pool POST

Destroys all idle browsers in the pool; leased browsers are not affected.