Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kernel Browsers API

Create and manage browser sessions.

Kernel Browsers API is one of 22 APIs that Kernel publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Browsers. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 9 operations across 6 paths, and defines 29 schemas. It is described by OpenAPI 3.1.0, at version 0.1.0.

Requests are made against a single base URL, https://api.onkernel.com.

9 operations 6 paths 29 schemas 1 DELETE2 GET1 PATCH5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.1.0
Base URL
https://api.onkernel.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Kernel Browsers API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

Paths & Operations 9

Across 6 paths, the API surfaces 9 operations — 1 DELETE, 2 GET, 1 PATCH, 5 POST. Each is listed below with its method, path, parameters, and response codes.

Browsers 9

Create and manage browser sessions.

POST
/browsers
Create a browser session
postBrowsers body → 200400401403429500529
GET
/browsers
List browser sessions
getBrowsers 5 params → 200401500
GET
/browsers/{id}
Get browser session details
getBrowsersById 2 params → 200401404500
DELETE
/browsers/{id}
Delete a browser session by ID.
deleteBrowsersById 1 param → 204400401404500
PATCH
/browsers/{id}
Update browser session
patchBrowsersById 1 param body → 200400401403404500
POST
/browsers/{id}/extensions
Ad-hoc upload one or more unpacked extensions to a running browser instance.
uploadExtensionsToBrowser 1 param body → 201400401403404500
POST
/browsers/{id}/computer/batch
Execute a batch of computer actions sequentially
batchComputerAction 1 param body → 200400404500
POST
/browsers/{id}/computer/get_mouse_position
Get the current mouse cursor position on the browser instance
getMousePosition 1 param → 200400404500
POST
/browsers/{id}/curl
Make an HTTP request through the browser's network stack
browserCurl 1 param body → 200400404500502

Schemas 29

The contract defines 29 schemas that model the data the API accepts and returns. The most detailed are Browser (20 properties), BrowserRequest (13 properties), ComputerAction (9 properties), DragMouseRequest (8 properties). Each schema is shown below with its type and property counts.

ErrorDetail
object
2 properties
BrowserTelemetryCategoryConfig
object
Per-category telemetry configuration.
1 property
BrowserCurlRequest
object
Request to make an HTTP request through the browser's network stack.
6 properties 1 required
PressKeyRequest
object
3 properties 1 required
BrowserUpdateRequest
object
Request body for updating a browser session.
5 properties
Error
object
4 properties 2 required
BatchComputerActionRequest
object
A batch of computer actions to execute sequentially.
1 property 1 required
SetCursorRequest
object
1 property 1 required
MoveMouseRequest
object
5 properties 2 required
BrowserTelemetryConfig
object
Telemetry configuration for a browser session.
1 property
TypeTextRequest
object
2 properties 1 required
BrowserRequest
object
Parameters for creating a browser session.
13 properties
ClickMouseRequest
object
6 properties 2 required
BrowserTelemetryCategoriesConfig
object
Per-category telemetry capture settings.
4 properties
ComputerAction
object
A single computer action to execute as part of a batch. The type field selects which action to perform, and the corresponding field contains the action paramet…
9 properties 1 required
DragMouseRequest
object
8 properties 1 required
ScrollRequest
object
5 properties 2 required
MousePositionResponse
object
2 properties 2 required
BrowserCurlResult
object
Structured response from the browser curl request.
4 properties 4 required
SleepAction
object
Pause execution for a specified duration.
1 property 1 required
BrowserProfile
object
Profile selection for the browser session. Provide either id or name. If specified, the matching profile will be loaded into the browser session. Profiles must…
3 properties
BrowserUsage
object
Session usage metrics.
1 property 1 required
Profile
object
Browser profile metadata.
5 properties 2 required
BrowserPoolRef
object
Browser pool this session was acquired from, if any.
2 properties 1 required
BrowserCurlTransportError
object
Transport-level error when the request could not complete.
3 properties 1 required
Browser
object
20 properties 7 required
BrowserViewportUpdate
Viewport configuration for updating a browser session. Extends BrowserViewport with update-only options.
BrowserViewport
object
Initial browser window size in pixels with optional refresh rate. If omitted, image defaults apply (1920x1080@25). For GPU images, the default is 1920x1080@60.…
3 properties 2 required
BrowserExtension
object
Extension selection for the browser session. Provide either id or name of an extension uploaded to Kernel.
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kernel-so-browsers-api-openapi.yml Raw ↑

Other APIs Kernel publishes across the network.

Kernel MCP Server
Kernel API Keys API
Kernel Apps API
Kernel Auth Connections API
Kernel Browser Computer Controls API
Kernel Browser Filesystem API
Kernel Browser Logs API
Kernel Browser Playwright API
Kernel Browser Pools API
Kernel Browser Processes API
Kernel Browser Replays API
Kernel Browser Telemetry API