{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/amazon-bedrock/json-schema/amazon-bedrock-create-browser-request-schema.json",
  "title": "CreateBrowserRequest",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/amazon-bedrock-browsers-api-openapi.yml#/components/schemas/CreateBrowserRequest",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The name of the browser. The name must be unique within your account."
    },
    "description": {
      "type": "string",
      "description": "The description of the browser."
    },
    "executionRoleArn": {
      "type": "string",
      "description": "The Amazon Resource Name (ARN) of the IAM role that provides permissions for the browser to access Amazon Web Services services."
    },
    "networkConfiguration": {
      "$ref": "#/$defs/BrowserNetworkConfiguration"
    },
    "recording": {
      "$ref": "#/$defs/RecordingConfig"
    },
    "browserSigning": {
      "$ref": "#/$defs/BrowserSigningConfigInput"
    },
    "enterprisePolicies": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/BedrockAgentcoreControlBrowserEnterprisePolicy"
      },
      "description": "A list of enterprise policy files for the browser."
    },
    "certificates": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Certificate"
      },
      "description": "A list of certificates to install in the browser."
    },
    "filesystemConfigurations": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/ToolsFileSystemConfiguration"
      },
      "description": "The file system configurations to mount into the browser. Use these configurations to mount your own Amazon Simple Storage Service (Amazon S3) Files or Amazon Elastic File System (Amazon EFS) access points. Your sessions can then access your data. If you don't specify this field, no file systems are mounted."
    },
    "clientToken": {
      "type": "string",
      "description": "A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, Amazon Bedrock AgentCore ignores the request but does not return an error."
    },
    "tags": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "A map of tag keys and values to assign to the browser. Tags enable you to categorize your resources in different ways, for example, by purpose, owner, or environment."
    }
  },
  "required": [
    "name",
    "networkConfiguration"
  ],
  "$defs": {
    "BedrockAgentcoreControlBrowserEnterprisePolicy": {
      "type": "object",
      "properties": {
        "location": {
          "$ref": "#/$defs/BedrockAgentcoreControlResourceLocation"
        },
        "type": {
          "type": "string",
          "enum": [
            "MANAGED",
            "RECOMMENDED"
          ],
          "description": "The type of browser enterprise policy. Available values are MANAGED and RECOMMENDED."
        }
      },
      "required": [
        "location"
      ]
    },
    "BedrockAgentcoreControlResourceLocation": {
      "type": "object",
      "properties": {
        "s3": {
          "$ref": "#/$defs/BedrockAgentcoreControlS3Location"
        }
      },
      "description": "Exactly one member is set."
    },
    "BedrockAgentcoreControlS3Location": {
      "type": "object",
      "properties": {
        "bucket": {
          "type": "string",
          "description": "The name of the Amazon S3 bucket. This bucket contains the stored data."
        },
        "prefix": {
          "type": "string",
          "description": "The prefix for objects in the Amazon S3 bucket. This prefix is added to the object keys to organize the data."
        },
        "versionId": {
          "type": "string",
          "description": "The version ID of the Amazon Amazon S3 object. If not specified, the latest version of the object is used."
        }
      },
      "required": [
        "bucket",
        "prefix"
      ]
    },
    "BedrockAgentcoreControlVpcConfig": {
      "type": "object",
      "properties": {
        "securityGroups": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The security groups associated with the VPC configuration."
        },
        "subnets": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The subnets associated with the VPC configuration."
        },
        "requireServiceS3Endpoint": {
          "type": "boolean",
          "description": "This field applies only to Agent Runtimes. It is not applicable to Browsers or Code Interpreters. Controls whether a service-managed Amazon S3 gateway endpoint is provisioned in the VPC network topology for the agent runtime. This gateway is used by Amazon Bedrock AgentCore Runtime to download code and container images during agent startup. Starting May 5, 2026, Amazon Bedrock AgentCore Runtime is gradually rolling out a change to how network isolation is configured for VPC mode agents. Agent runtimes created on or after this rollout will no longer include the service-managed Amazon S3 gateway"
        }
      },
      "required": [
        "securityGroups",
        "subnets"
      ]
    },
    "BrowserNetworkConfiguration": {
      "type": "object",
      "properties": {
        "networkMode": {
          "type": "string",
          "enum": [
            "PUBLIC",
            "VPC"
          ],
          "description": "The network mode for the browser. This field specifies how the browser connects to the network."
        },
        "vpcConfig": {
          "$ref": "#/$defs/BedrockAgentcoreControlVpcConfig"
        }
      },
      "required": [
        "networkMode"
      ]
    },
    "BrowserSigningConfigInput": {
      "type": "object",
      "properties": {
        "enabled": {
          "type": "boolean",
          "description": "Specifies whether browser signing is enabled. When enabled, the browser will cryptographically sign HTTP requests to identify itself as an AI agent to bot control vendors."
        }
      },
      "required": [
        "enabled"
      ]
    },
    "Certificate": {
      "type": "object",
      "properties": {
        "location": {
          "$ref": "#/$defs/CertificateLocation"
        }
      },
      "required": [
        "location"
      ]
    },
    "CertificateLocation": {
      "type": "object",
      "properties": {
        "secretsManager": {
          "$ref": "#/$defs/SecretsManagerLocation"
        }
      },
      "description": "Exactly one member is set."
    },
    "EfsConfiguration": {
      "type": "object",
      "properties": {
        "accessPointArn": {
          "type": "string",
          "description": "The Amazon Resource Name (ARN) of the Amazon Elastic File System (Amazon EFS) access point to mount."
        },
        "mountPath": {
          "type": "string",
          "description": "The absolute path within the session at which the access point is mounted, for example /mnt/efs. Each mount path must be unique across all file system configurations in the session."
        },
        "fileSystemArn": {
          "type": "string",
          "description": "The Amazon Resource Name (ARN) of the Amazon Elastic File System (Amazon EFS) file system that owns the access point."
        }
      },
      "required": [
        "accessPointArn",
        "mountPath",
        "fileSystemArn"
      ]
    },
    "RecordingConfig": {
      "type": "object",
      "properties": {
        "enabled": {
          "type": "boolean",
          "description": "Indicates whether recording is enabled for the browser. When set to true, browser sessions are recorded."
        },
        "s3Location": {
          "$ref": "#/$defs/BedrockAgentcoreControlS3Location"
        }
      }
    },
    "S3FilesConfiguration": {
      "type": "object",
      "properties": {
        "accessPointArn": {
          "type": "string",
          "description": "The Amazon Resource Name (ARN) of the Amazon Simple Storage Service (Amazon S3) Files access point to mount."
        },
        "mountPath": {
          "type": "string",
          "description": "The absolute path within the session at which the access point is mounted, for example /mnt/s3data. Each mount path must be unique across all file system configurations in the session."
        },
        "fileSystemArn": {
          "type": "string",
          "description": "The Amazon Resource Name (ARN) of the Amazon Simple Storage Service (Amazon S3) Files file system that owns the access point."
        }
      },
      "required": [
        "accessPointArn",
        "mountPath",
        "fileSystemArn"
      ]
    },
    "SecretsManagerLocation": {
      "type": "object",
      "properties": {
        "secretArn": {
          "type": "string",
          "description": "The ARN of the Amazon Web Services Secrets Manager secret containing the certificate."
        }
      },
      "required": [
        "secretArn"
      ]
    },
    "ToolsFileSystemConfiguration": {
      "type": "object",
      "properties": {
        "s3FilesConfiguration": {
          "$ref": "#/$defs/S3FilesConfiguration"
        },
        "efsConfiguration": {
          "$ref": "#/$defs/EfsConfiguration"
        }
      },
      "description": "Exactly one member is set."
    }
  }
}