Appearance
Fresh 🌱
Make an HTTP request through the browser's network stack ​
Sends an HTTP request through Chrome's HTTP request stack, inheriting the browser's TLS fingerprint, cookies, proxy configuration, and headers. Returns a structured JSON response with status, headers, body, and timing.
OpenAPI ​
yaml
openapi: 3.1.0
info:
title: Kernel API
description: Developer tools and cloud infrastructure for AI agents to use web browsers
version: 0.1.0
servers:
- url: https://api.onkernel.com
description: API Server
security:
- bearerAuth: []
tags:
- name: Browsers
description: Create and manage browser sessions.
- name: Browser Replays
description: Record and manage browser session video replays.
- name: Profiles
description: Create, list, retrieve, and delete browser profiles.
- name: Browser Filesystem
description: Read, write, and manage files on the browser instance.
- name: Browser Computer Controls
description: Control mouse, keyboard, and screen on the browser instance.
- name: Browser Playwright
description: Execute Playwright code against the browser instance.
- name: Browser Processes
description: Execute and manage processes on the browser instance.
- name: Browser Logs
description: Stream logs from the browser instance.
- name: Extensions
description: Create, list, retrieve, and delete browser extensions.
- name: Proxies
description: Create and manage proxy configurations for routing browser traffic.
- name: Browser Pools
description: Create and manage browser pools for acquiring and releasing browsers.
- name: Managed Auth
description: >-
Create and manage auth connections for automated credential capture and
login.
- name: Credentials
description: Create and manage credentials for authentication.
- name: Credential Providers
description: Configure external credential providers like 1Password.
- name: Apps
description: List applications and versions.
- name: Deployments
description: Create and manage app deployments and stream deployment events.
- name: Invocations
description: Invoke actions and stream or query invocation status and events.
- name: Projects
description: Create and manage projects for resource isolation within an organization.
paths:
/browsers/{id}/curl:
post:
tags:
- Browsers
summary: Make an HTTP request through the browser's network stack
description: >
Sends an HTTP request through Chrome's HTTP request stack, inheriting
the browser's TLS fingerprint, cookies, proxy configuration, and
headers.
Returns a structured JSON response with status, headers, body, and
timing.
operationId: browserCurl
parameters:
- name: id
in: path
required: true
description: Browser session ID
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/BrowserCurlRequest'
responses:
'200':
description: Response from target URL
content:
application/json:
schema:
$ref: '#/components/schemas/BrowserCurlResult'
'400':
$ref: '#/components/responses/BadRequest'
'404':
$ref: '#/components/responses/NotFound'
'500':
$ref: '#/components/responses/InternalError'
'502':
description: Upstream transport failure
content:
application/json:
schema:
$ref: '#/components/schemas/BrowserCurlTransportError'
security:
- bearerAuth: []
x-codeSamples:
- lang: JavaScript
source: |-
import Kernel from '@onkernel/sdk';
const client = new Kernel({
apiKey: process.env['KERNEL_API_KEY'], // This is the default and can be omitted
});
const response = await client.browsers.curl('id', { url: 'url' });
console.log(response.body);
- lang: Python
source: |-
import os
from kernel import Kernel
client = Kernel(
api_key=os.environ.get("KERNEL_API_KEY"), # This is the default and can be omitted
)
response = client.browsers.curl(
id="id",
url="url",
)
print(response.body)
- lang: Go
source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/kernel/kernel-go-sdk\"\n\t\"github.com/kernel/kernel-go-sdk/option\"\n)\n\nfunc main() {\n\tclient := kernel.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tresponse, err := client.Browsers.Curl(\n\t\tcontext.TODO(),\n\t\t\"id\",\n\t\tkernel.BrowserCurlParams{\n\t\t\tURL: \"url\",\n\t\t},\n\t)\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", response.Body)\n}\n"
components:
schemas:
BrowserCurlRequest:
type: object
description: Request to make an HTTP request through the browser's network stack.
required:
- url
properties:
url:
type: string
description: Target URL (must be http or https).
method:
type: string
description: HTTP method.
enum:
- GET
- HEAD
- POST
- PUT
- PATCH
- DELETE
- OPTIONS
default: GET
headers:
type: object
description: Custom headers merged with browser defaults.
additionalProperties:
type: string
body:
type: string
description: Request body (for POST/PUT/PATCH).
timeout_ms:
type: integer
description: Request timeout in milliseconds.
minimum: 1000
maximum: 60000
default: 30000
response_encoding:
type: string
description: Encoding for the response body. Use base64 for binary content.
enum:
- utf8
- base64
default: utf8
additionalProperties: false
BrowserCurlResult:
type: object
description: Structured response from the browser curl request.
required:
- status
- headers
- body
- duration_ms
properties:
status:
type: integer
description: HTTP status code from target.
headers:
type: object
description: Response headers (multi-value).
additionalProperties:
type: array
items:
type: string
body:
type: string
description: Response body (UTF-8 string or base64 depending on request).
duration_ms:
type: integer
description: Total request duration in milliseconds.
additionalProperties: false
BrowserCurlTransportError:
type: object
description: Transport-level error when the request could not complete.
required:
- message
properties:
message:
type: string
description: Human-readable error description.
net_error:
type: integer
description: Chromium net error code.
net_error_name:
type: string
description: Chromium net error name.
additionalProperties: false
Error:
type: object
required:
- code
- message
properties:
code:
type: string
description: Application-specific error code (machine-readable)
example: bad_request
message:
type: string
description: Human-readable error description for debugging
example: 'Missing required field: app_name'
details:
type: array
description: Additional error details (for multiple errors)
items:
$ref: '#/components/schemas/ErrorDetail'
inner_error:
$ref: '#/components/schemas/ErrorDetail'
ErrorDetail:
type: object
properties:
code:
type: string
description: Lower-level error code providing more specific detail
example: invalid_input
message:
type: string
description: Further detail about the error
example: Provided version string is not semver compliant
responses:
BadRequest:
description: Bad Request - invalid input
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
NotFound:
description: Resource not found
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
InternalError:
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
bearerAuth:
type: http
scheme: bearer