Sign in
latestOpenAPI 3.1.02026-08-22154287463.4 KB

858365328f92

Site Configs

Resolve a Site Config

Explicitly starts or retries a project-scoped background analysis while preserving current global knowledge when available. Use /site-configs/lookup for side-effect-free reads.

post/site-configs/resolve

Request body

allowed_proxy_countriesstring[]

ISO 3166 country codes Kernel may use when searching for or returning a proxy configuration. Kernel may test a subset of allowed countries. When omitted, Kernel uses its default country selection.

urlstring uri required

Public HTTP(S) URL to refresh.

Example request

{
  "allowed_proxy_countries": [
    "US"
  ]
}

Response

Current recommendation returned. Analysis is null if DNS validation or workflow submission prevented the requested refresh.

Example response

{
  "analysis": {
    "failure": {
      "code": "bad_request",
      "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"
      },
      "message": "Missing required field: app_name"
    }
  },
  "recommendation": {
    "browser": {
      "viewport": {
        "height": 800,
        "refresh_rate": 60,
        "width": 1280
      }
    },
    "proxy": {
      "create": {
        "config": {
          "country": "US"
        }
      }
    }
  }
}