List configs

curl --request GET \
  --url https://api.onkernel.com/config-registry \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.onkernel.com/config-registry', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.onkernel.com/config-registry",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.onkernel.com/config-registry"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.onkernel.com/config-registry")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

[
  {
    "analysis_id": "<string>",
    "analysis_status": "running",
    "last_requested_at": "2023-11-07T05:31:56Z",
    "recommendation": {
      "browser": {
        "gpu": true,
        "headless": true,
        "stealth": true,
        "viewport": {
          "height": 800,
          "width": 1280,
          "refresh_rate": 60
        }
      },
      "evidence": {
        "accessed": 1,
        "blocked": 1,
        "inconclusive": 1,
        "last_observed_at": "2023-11-07T05:31:56Z",
        "run_count": 1,
        "sample_size": 1,
        "success_rate": 0.5,
        "last_supported_at": "2023-11-07T05:31:56Z"
      },
      "match_scope": "exact",
      "matched_target": "<string>",
      "proxy": {
        "mode": "direct"
      },
      "type": "recommendation"
    },
    "recommended_config_label": "<string>",
    "success_rate": 0.5,
    "target": "<string>"
  }
]

{
  "code": "bad_request",
  "message": "Missing required field: app_name",
  "details": [
    {
      "code": "invalid_input",
      "message": "Provided version string is not semver compliant"
    }
  ],
  "inner_error": {
    "code": "invalid_input",
    "message": "Provided version string is not semver compliant"
  }
}

{
  "code": "bad_request",
  "message": "Missing required field: app_name",
  "details": [
    {
      "code": "invalid_input",
      "message": "Provided version string is not semver compliant"
    }
  ],
  "inner_error": {
    "code": "invalid_input",
    "message": "Provided version string is not semver compliant"
  }
}

{
  "code": "bad_request",
  "message": "Missing required field: app_name",
  "details": [
    {
      "code": "invalid_input",
      "message": "Provided version string is not semver compliant"
    }
  ],
  "inner_error": {
    "code": "invalid_input",
    "message": "Provided version string is not semver compliant"
  }
}

{
  "code": "bad_request",
  "message": "Missing required field: app_name",
  "details": [
    {
      "code": "invalid_input",
      "message": "Provided version string is not semver compliant"
    }
  ],
  "inner_error": {
    "code": "invalid_input",
    "message": "Provided version string is not semver compliant"
  }
}

{
  "code": "bad_request",
  "message": "Missing required field: app_name",
  "details": [
    {
      "code": "invalid_input",
      "message": "Provided version string is not semver compliant"
    }
  ],
  "inner_error": {
    "code": "invalid_input",
    "message": "Provided version string is not semver compliant"
  }
}

GET

config-registry

List configs

curl --request GET \
  --url https://api.onkernel.com/config-registry \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.onkernel.com/config-registry', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.onkernel.com/config-registry",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.onkernel.com/config-registry"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.onkernel.com/config-registry")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

[
  {
    "analysis_id": "<string>",
    "analysis_status": "running",
    "last_requested_at": "2023-11-07T05:31:56Z",
    "recommendation": {
      "browser": {
        "gpu": true,
        "headless": true,
        "stealth": true,
        "viewport": {
          "height": 800,
          "width": 1280,
          "refresh_rate": 60
        }
      },
      "evidence": {
        "accessed": 1,
        "blocked": 1,
        "inconclusive": 1,
        "last_observed_at": "2023-11-07T05:31:56Z",
        "run_count": 1,
        "sample_size": 1,
        "success_rate": 0.5,
        "last_supported_at": "2023-11-07T05:31:56Z"
      },
      "match_scope": "exact",
      "matched_target": "<string>",
      "proxy": {
        "mode": "direct"
      },
      "type": "recommendation"
    },
    "recommended_config_label": "<string>",
    "success_rate": 0.5,
    "target": "<string>"
  }
]

{
  "code": "bad_request",
  "message": "Missing required field: app_name",
  "details": [
    {
      "code": "invalid_input",
      "message": "Provided version string is not semver compliant"
    }
  ],
  "inner_error": {
    "code": "invalid_input",
    "message": "Provided version string is not semver compliant"
  }
}

{
  "code": "bad_request",
  "message": "Missing required field: app_name",
  "details": [
    {
      "code": "invalid_input",
      "message": "Provided version string is not semver compliant"
    }
  ],
  "inner_error": {
    "code": "invalid_input",
    "message": "Provided version string is not semver compliant"
  }
}

{
  "code": "bad_request",
  "message": "Missing required field: app_name",
  "details": [
    {
      "code": "invalid_input",
      "message": "Provided version string is not semver compliant"
    }
  ],
  "inner_error": {
    "code": "invalid_input",
    "message": "Provided version string is not semver compliant"
  }
}

{
  "code": "bad_request",
  "message": "Missing required field: app_name",
  "details": [
    {
      "code": "invalid_input",
      "message": "Provided version string is not semver compliant"
    }
  ],
  "inner_error": {
    "code": "invalid_input",
    "message": "Provided version string is not semver compliant"
  }
}

{
  "code": "bad_request",
  "message": "Missing required field: app_name",
  "details": [
    {
      "code": "invalid_input",
      "message": "Provided version string is not semver compliant"
    }
  ],
  "inner_error": {
    "code": "invalid_input",
    "message": "Provided version string is not semver compliant"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit

integer

default:20

Required range: 1 <= x <= 100

offset

integer

default:0

Required range: x >= 0

string

Case-insensitive substring search over normalized targets, including domain, subdomain, and path.

Maximum string length: 2048

sort_by

enum<string>

default:last_requested_at

Available options:

target,

analysis_status,

recommended_config,

last_requested_at,

success_rate

sort_order

enum<string>

default:desc

Available options:

asc,

desc

Response

Project-scoped recommended configurations.

analysis_id

string

required

ID of the most recently requested analysis for this exact target.

analysis_status

enum<string>

required

Lifecycle status of the most recently requested analysis for this exact target.

Available options:

running,

completed,

failed,

canceled,

expired

last_requested_at

string<date-time>

required

Most recent time the selected project requested an analysis for this exact target.

recommendation

object | null

required

Recommendation produced by the latest analysis. Null when that analysis did not produce one.

Show child attributes

recommended_config_label

string | null

required

Display label for the recommended browser configuration.

success_rate

number | null

required

Success rate for the recommended configuration. Null when the latest analysis did not produce one.

Required range: 0 <= x <= 1

target

string

required

Normalized exact target previously analyzed by the selected project, including scheme, host, port, and path.

Apps

Audit Logs

Managed Auth

Authentication

Browser Pools

Browsers

Browser Computer Controls

Browser Filesystem

Browser Logs

Browser Playwright

Browser Processes

Browser Replays

Browser Telemetry

Browser WebMCP

Config Registry

Deployments

Extensions

Invocations

API Keys

Organization

Projects

Profiles

Proxies

Vaults

List configs

Authorizations

Query Parameters

Response