> ## Documentation Index > Fetch the complete documentation index at: https://tbd-6fc993ce-feature-cookbooks-skills-banner.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List configs > Lists unique exact targets previously analyzed by the selected project with the recommendation produced by each target's latest analysis. ## OpenAPI ````yaml https://api.onkernel.com/spec.json get /config-registry openapi: 3.1.0 info: description: Developer tools and cloud infrastructure for AI agents to use web browsers title: Kernel API version: 0.1.0 servers: - description: API Server url: https://api.onkernel.com security: - bearerAuth: [] tags: - description: Create and manage browser sessions. name: Browsers - description: Control mouse, keyboard, and screen on the browser instance. name: Browser Computer Controls - description: Execute Playwright code against the browser instance. name: Browser Playwright - description: Discover and invoke native page tools across the browser instance. name: Browser WebMCP - description: Read, write, and manage files on the browser instance. name: Browser Filesystem - description: Execute and manage processes on the browser instance. name: Browser Processes - description: Record and manage browser session video replays. name: Browser Replays - description: Stream logs from the browser instance. name: Browser Logs - description: >- Stream live telemetry events from a browser session, and manage the destinations sessions export them to. name: Browser Telemetry - description: Create, list, retrieve, and delete browser profiles. name: Profiles - description: Create and manage proxy configurations for routing browser traffic. name: Proxies - description: Create, list, retrieve, and delete browser extensions. name: Extensions - description: Create and manage browser pools for acquiring and releasing browsers. name: Browser Pools - description: Inspect the identity and authorization context for the current request. name: Authentication - description: >- Create and manage auth connections for automated credential capture and login. name: Managed Auth - description: Create and manage credentials for authentication. name: Credentials - description: Configure external credential providers like 1Password. name: Credential Providers - description: List applications and versions. name: Apps - description: Create and manage app deployments and stream deployment events. name: Deployments - description: Invoke actions and stream or query invocation status and events. name: Invocations - description: Read and manage organization-level limits. name: Organization - description: | Create and manage projects for resource isolation within an organization. When projects are disabled for the organization, project operations return `404` with code `projects_disabled`. name: Projects - description: Create and manage API keys for organization and project-scoped access. name: API Keys - description: Read audit log records for the authenticated organization. name: Audit Logs - description: Resolve browser and proxy recommendations for bot-protected sites. name: Config Registry paths: /config-registry: get: tags: - Config Registry summary: List configs description: >- Lists unique exact targets previously analyzed by the selected project with the recommendation produced by each target's latest analysis. operationId: getConfigRegistry parameters: - in: query name: limit required: false schema: default: 20 maximum: 100 minimum: 1 type: integer - in: query name: offset required: false schema: default: 0 minimum: 0 type: integer - description: >- Case-insensitive substring search over normalized targets, including domain, subdomain, and path. in: query name: search required: false schema: maxLength: 2048 type: string - in: query name: sort_by required: false schema: default: last_requested_at enum: - target - analysis_status - recommended_config - last_requested_at - success_rate type: string x-enum-varnames: - ConfigRegistrySortByTarget - ConfigRegistrySortByAnalysisStatus - ConfigRegistrySortByRecommendedConfig - ConfigRegistrySortByLastRequestedAt - ConfigRegistrySortBySuccessRate - in: query name: sort_order required: false schema: default: desc enum: - asc - desc type: string x-enum-varnames: - ConfigRegistrySortOrderAsc - ConfigRegistrySortOrderDesc responses: '200': content: application/json: schema: items: $ref: '#/components/schemas/ConfigRegistryRecommendationSummary' type: array description: Project-scoped recommended configurations. headers: X-Has-More: description: Whether more results are available. schema: type: boolean X-Limit: description: The limit used for pagination. schema: type: integer X-Next-Offset: description: >- The offset where the next page starts. 0 when there are no more results. schema: type: integer X-Offset: description: The offset used for pagination. schema: type: integer X-Total-Count: description: >- Total unique exact targets matching the current project and search. schema: type: integer '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalError' components: schemas: ConfigRegistryRecommendationSummary: properties: analysis_id: description: ID of the most recently requested analysis for this exact target. type: string analysis_status: $ref: '#/components/schemas/ConfigRegistryAnalysisStatus' description: >- Lifecycle status of the most recently requested analysis for this exact target. last_requested_at: description: >- Most recent time the selected project requested an analysis for this exact target. format: date-time type: string recommendation: allOf: - $ref: '#/components/schemas/ConfigRegistryRecommendation' description: >- Recommendation produced by the latest analysis. Null when that analysis did not produce one. nullable: true recommended_config_label: description: Display label for the recommended browser configuration. nullable: true type: string success_rate: description: >- Success rate for the recommended configuration. Null when the latest analysis did not produce one. maximum: 1 minimum: 0 nullable: true type: number target: description: >- Normalized exact target previously analyzed by the selected project, including scheme, host, port, and path. type: string required: - target - analysis_id - analysis_status - recommendation - recommended_config_label - last_requested_at - success_rate type: object ConfigRegistryAnalysisStatus: description: Lifecycle status of a background analysis. enum: - running - completed - failed - canceled - expired type: string x-enum-varnames: - ConfigRegistryAnalysisStatusRunning - ConfigRegistryAnalysisStatusCompleted - ConfigRegistryAnalysisStatusFailed - ConfigRegistryAnalysisStatusCanceled - ConfigRegistryAnalysisStatusExpired ConfigRegistryRecommendation: properties: browser: $ref: '#/components/schemas/ConfigRegistryBrowser' evidence: $ref: '#/components/schemas/ConfigRegistryEvidence' match_scope: description: >- Specificity of knowledge matched for this recommendation. Exact matches use knowledge for the requested target; host and domain matches use broader fallback knowledge. enum: - exact - host - domain type: string x-enum-varnames: - ConfigRegistryRecommendationMatchScopeExact - ConfigRegistryRecommendationMatchScopeHost - ConfigRegistryRecommendationMatchScopeDomain matched_target: description: Target value that supplied the recommendation. type: string proxy: $ref: '#/components/schemas/ConfigRegistryProxy' type: const: recommendation type: string required: - type - browser - proxy - match_scope - matched_target - evidence type: object Error: properties: code: description: Application-specific error code (machine-readable) example: bad_request type: string details: description: Additional error details (for multiple errors) items: $ref: '#/components/schemas/ErrorDetail' type: array inner_error: $ref: '#/components/schemas/ErrorDetail' message: description: Human-readable error description for debugging example: 'Missing required field: app_name' type: string required: - code - message type: object ConfigRegistryBrowser: description: Browser settings that can be passed directly to `POST /browsers`. properties: gpu: type: boolean headless: type: boolean stealth: type: boolean viewport: $ref: '#/components/schemas/BrowserViewport' required: - stealth - headless - gpu - viewport type: object ConfigRegistryEvidence: properties: accessed: minimum: 0 type: integer blocked: minimum: 0 type: integer inconclusive: minimum: 0 type: integer last_observed_at: description: >- Most recent contributing observation. Recommendations remain eligible regardless of age and can be returned while a new analysis refreshes them. format: date-time type: string last_supported_at: description: >- Most recent contributing run whose evidence supported recommending this configuration. Omitted when no individual run independently met the recommendation threshold. format: date-time nullable: true type: string run_count: minimum: 0 type: integer sample_size: description: Number of judged trials. minimum: 0 type: integer success_rate: description: >- Accessed trials divided by judged trials. Inconclusive trials are excluded. maximum: 1 minimum: 0 type: number required: - success_rate - sample_size - accessed - blocked - inconclusive - run_count - last_observed_at type: object ConfigRegistryProxy: description: Proxy recipe for the recommended browser. discriminator: mapping: direct: $ref: '#/components/schemas/ConfigRegistryDirectProxy' managed: $ref: '#/components/schemas/ConfigRegistryManagedProxy' propertyName: mode oneOf: - $ref: '#/components/schemas/ConfigRegistryDirectProxy' - $ref: '#/components/schemas/ConfigRegistryManagedProxy' ErrorDetail: properties: code: description: Lower-level error code providing more specific detail example: invalid_input type: string message: description: Further detail about the error example: Provided version string is not semver compliant type: string type: object BrowserViewport: description: > 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. Arbitrary viewport dimensions and refresh rates are accepted. Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25, 1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@60. For GPU images, recommended presets use one of these resolutions with refresh rates 60, 30, 25, or 10: 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768, 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600. Viewports outside this list may exhibit unstable live view or recording behavior. If refresh_rate is not provided, it will be automatically determined based on the resolution (higher resolutions use lower refresh rates to keep bandwidth reasonable). properties: height: description: Browser window height in pixels. Any positive integer is accepted. example: 800 minimum: 1 type: integer refresh_rate: description: >- Display refresh rate in Hz. Any positive integer is accepted; if omitted, automatically determined from width and height. example: 60 minimum: 1 type: integer width: description: Browser window width in pixels. Any positive integer is accepted. example: 1280 minimum: 1 type: integer required: - width - height type: object ConfigRegistryDirectProxy: additionalProperties: false description: > Direct egress recipe. Pass `{ "mode": "direct" }` as the browser's `proxy`. properties: mode: enum: - direct type: string x-enum-varnames: - ConfigRegistryDirectProxyModeDirect required: - mode type: object ConfigRegistryManagedProxy: additionalProperties: false description: > Managed proxy recipe. `create` is a non-idempotent `POST /proxies` payload: create the resource once, retain its ID, and reuse that ID as the browser's `proxy.id`. Do not submit this recipe before every browser session. properties: create: $ref: '#/components/schemas/ProxyCreateRequest' mode: enum: - managed type: string x-enum-varnames: - ConfigRegistryManagedProxyModeManaged required: - mode - create type: object ProxyCreateRequest: description: Configuration for routing traffic through a proxy. discriminator: mapping: custom: $ref: '#/components/schemas/CustomProxyConfig' datacenter: $ref: '#/components/schemas/DatacenterProxyConfig' isp: $ref: '#/components/schemas/IspProxyConfig' mobile: $ref: '#/components/schemas/MobileProxyConfig' residential: $ref: '#/components/schemas/ResidentialProxyConfig' propertyName: type properties: bypass_hosts: description: Hostnames that should bypass the parent proxy and connect directly. items: type: string type: array config: description: Configuration specific to the selected proxy `type`. oneOf: - $ref: '#/components/schemas/DatacenterProxyConfig' - $ref: '#/components/schemas/IspProxyConfig' - $ref: '#/components/schemas/ResidentialProxyConfig' - $ref: '#/components/schemas/MobileProxyConfig' - $ref: '#/components/schemas/CreateCustomProxyConfig' name: description: Readable name of the proxy. type: string protocol: default: https description: Protocol to use for the proxy connection. enum: - http - https type: string type: description: > Proxy type to use. In terms of quality for avoiding bot-detection, from best to worst: `mobile` > `residential` > `isp` > `datacenter`. enum: - datacenter - isp - residential - mobile - custom type: string required: - type type: object CustomProxyConfig: description: Configuration for a custom proxy (e.g., private proxy server). properties: has_ca_bundle: description: Whether the proxy has a custom CA bundle configured. example: true type: boolean has_password: description: Whether the proxy has a password. example: true type: boolean host: description: Proxy host address or IP. example: 127.0.0.1 type: string port: description: Proxy port. example: 8080 type: integer username: description: Username for proxy authentication. example: user123 type: string required: - host - port title: Custom type: object DatacenterProxyConfig: description: Configuration for a datacenter proxy. properties: country: description: ISO 3166 country code. Defaults to US if not provided. example: US type: string title: Datacenter type: object IspProxyConfig: description: Configuration for an ISP proxy. properties: country: description: >- ISO 3166 country code. Supported countries are US, GB, FR, DE, and SG. Defaults to US if not provided. example: US type: string title: ISP type: object MobileProxyConfig: description: Configuration for mobile proxies. properties: city: description: >- Provider city alias. Mobile carrier routing can make observed geo vary. example: brooklyn type: string country: description: >- ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting. example: US type: string state: description: >- US-only state code. Mobile carrier routing can make observed geo vary. example: NY type: string title: Mobile type: object ResidentialProxyConfig: description: Configuration for residential proxies. properties: asn: description: >- Autonomous system number. See https://bgp.potaroo.net/cidr/autnums.html example: AS15169 type: string city: description: >- City name (no spaces, e.g. `sanfrancisco`). If provided, `country` must also be provided. example: sanfrancisco type: string country: description: >- ISO 3166 country code. If omitted, the proxy uses the global pool without country targeting. example: US type: string os: deprecated: true description: Operating system of the residential device. enum: - windows - macos - android type: string x-deprecated-reason: os selection not supported by proxy provider state: description: Two-letter state code. example: CA type: string zip: description: US ZIP code. example: '94107' type: string title: Residential type: object CreateCustomProxyConfig: description: Configuration for a custom proxy (e.g., private proxy server). properties: ca_bundle: description: >- PEM-encoded CA certificate bundle the proxy re-signs upstream TLS with. Provide when the proxy terminates TLS (MITM) so the browser trusts its certificates. May contain multiple concatenated certificates. example: | -----BEGIN CERTIFICATE----- MIIB... -----END CERTIFICATE----- maxLength: 65536 type: string host: description: Proxy host address or IP. example: 127.0.0.1 type: string password: description: Password for proxy authentication. example: secret maxLength: 4096 type: string port: description: Proxy port. example: 8080 type: integer username: description: Username for proxy authentication. example: user123 type: string required: - host - port title: Custom type: object responses: BadRequest: content: application/json: schema: $ref: '#/components/schemas/Error' description: Bad Request – invalid input Unauthorized: content: application/json: schema: $ref: '#/components/schemas/Error' description: Unauthorized – missing or invalid authorization token Forbidden: content: application/json: schema: $ref: '#/components/schemas/Error' description: Forbidden – insufficient permissions or plan NotFound: content: application/json: schema: $ref: '#/components/schemas/Error' description: Resource not found InternalError: content: application/json: schema: $ref: '#/components/schemas/Error' description: Internal Server Error securitySchemes: bearerAuth: scheme: bearer type: http ````