{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/agentpmt-com/json-schema/agentpmt-com-start-capture-request-schema.json",
  "title": "StartCaptureRequest",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/agentpmt-com-browser-identities-api-openapi.yml#/components/schemas/StartCaptureRequest",
  "properties": {
    "initial_url": {
      "type": "string",
      "maxLength": 4096,
      "minLength": 1,
      "title": "Initial Url"
    },
    "site_origin": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 4096
        },
        {
          "type": "null"
        }
      ],
      "title": "Site Origin"
    },
    "allowed_origins": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Allowed Origins"
    },
    "helper_name": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 64
        },
        {
          "type": "null"
        }
      ],
      "title": "Helper Name"
    },
    "display_name": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 120
        },
        {
          "type": "null"
        }
      ],
      "title": "Display Name"
    },
    "account_hint": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 240
        },
        {
          "type": "null"
        }
      ],
      "title": "Account Hint"
    },
    "egress_mode": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 32
        },
        {
          "type": "null"
        }
      ],
      "title": "Egress Mode"
    },
    "droplet_instance_id": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 64
        },
        {
          "type": "null"
        }
      ],
      "title": "Droplet Instance Id"
    },
    "browser_session_options": {
      "anyOf": [
        {
          "$ref": "#/$defs/BrowserSessionOptions"
        },
        {
          "type": "null"
        }
      ]
    },
    "start_request_id": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 128,
          "minLength": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Start Request Id"
    }
  },
  "type": "object",
  "required": [
    "initial_url"
  ],
  "$defs": {
    "BrowserProxyGeolocation": {
      "properties": {
        "country": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 2,
              "minLength": 2
            },
            {
              "type": "null"
            }
          ],
          "title": "Country",
          "description": "Two-letter country code for managed-proxy geolocation."
        },
        "state": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 64
            },
            {
              "type": "null"
            }
          ],
          "title": "State",
          "description": "Optional US state for managed-proxy geolocation."
        },
        "city": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 64
            },
            {
              "type": "null"
            }
          ],
          "title": "City",
          "description": "Optional city for managed-proxy geolocation."
        }
      },
      "type": "object",
      "title": "BrowserProxyGeolocation"
    },
    "BrowserSessionOptions": {
      "properties": {
        "managed_proxy": {
          "type": "boolean",
          "title": "Managed Proxy",
          "description": "Route this session through managed residential proxies.",
          "default": false
        },
        "proxy_geolocation": {
          "anyOf": [
            {
              "$ref": "#/$defs/BrowserProxyGeolocation"
            },
            {
              "type": "null"
            }
          ],
          "description": "Optional managed-proxy geolocation. Requires managed_proxy=true."
        },
        "proxy_server": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 4096
            },
            {
              "type": "null"
            }
          ],
          "title": "Proxy Server",
          "description": "Optional bring-your-own proxy server URL for this session."
        },
        "solve_captcha": {
          "type": "boolean",
          "title": "Solve Captcha",
          "description": "Enable automated CAPTCHA solving for this session.",
          "default": false
        },
        "auto_solve_captcha": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "title": "Auto Solve Captcha",
          "description": "When solve_captcha=true, controls automatic CAPTCHA solving."
        },
        "device": {
          "anyOf": [
            {
              "type": "string",
              "const": "mobile"
            },
            {
              "type": "null"
            }
          ],
          "title": "Device",
          "description": "Use mobile mode for a consistent mobile device fingerprint."
        },
        "region": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 32
            },
            {
              "type": "null"
            }
          ],
          "title": "Region",
          "description": "Optional region for this browser session."
        },
        "user_agent": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 512
            },
            {
              "type": "null"
            }
          ],
          "title": "User Agent",
          "description": "Optional custom user agent for this browser session."
        }
      },
      "type": "object",
      "title": "BrowserSessionOptions"
    }
  }
}