Amazon Bedrock Bedrock Browsers API

The Bedrock Browsers API from Amazon Bedrock — 2 operation(s) for bedrock browsers.

GitHub OpenAPI

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

PUT /browsers Create a custom browser · Create Browser #
Ask an LLM
“How do I create a custom browser with its own execution role and network config?”
“Can I install enterprise policies and certificates on a new browser?”
Tell an agent
Create a browser named {name} with network config {networkConfiguration}.
Create browser {name} using role {executionRoleArn} and network config {networkConfiguration}.
POST /browsers List custom browsers · List Browsers #
Ask an LLM
“Which custom browsers do I have in my account?”
“Can I list only the browser recordings or enterprise policy browsers?”
Tell an agent
List all my custom browsers.
List {type} browsers.
GET /browsers/{browserId} Get a custom browser · Get Browser #
Ask an LLM
“What execution role and network config does a specific browser have?”
“Can I look up one custom browser by its ID?”
Tell an agent
Get browser {browserId}.
Show the network configuration of browser {browserId}.
DELETE /browsers/{browserId} Delete a custom browser · Delete Browser #
Ask an LLM
“How do I delete a custom browser I no longer use?”
“Can I delete a browser by its ID?”
Tell an agent destructive · confirm first
Delete browser {browserId}.
Remove the custom browser {browserId}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/amazon-bedrock:amazon-bedrock-browsers-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

amazon-bedrock-browsers-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Amazon Bedrock Browsers API
  version: '2023-04-20'
  description: Generated from AWS's published Smithy model for Amazon Bedrock. 4 operation(s).
  contact:
    name: Amazon Web Services
    url: https://aws.amazon.com/contact-us/
  license:
    name: Apache 2.0
    identifier: Apache-2.0
    url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://bedrock-agentcore-control.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
paths:
  /browsers:
    put:
      operationId: CreateBrowser
      summary: Create Browser
      description: Creates a custom browser.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateBrowserResponse'
        '403':
          description: AccessDeniedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '409':
          description: ConflictException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConflictException'
        '500':
          description: InternalServerException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '402':
          description: ServiceQuotaExceededException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceQuotaExceededException'
        '429':
          description: ThrottlingException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThrottlingException'
        '400':
          description: ValidationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BedrockAgentcoreControlValidationException'
      requestBody:
        content:
          application/json:
            schema:
              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: '#/components/schemas/BrowserNetworkConfiguration'
                recording:
                  $ref: '#/components/schemas/RecordingConfig'
                browserSigning:
                  $ref: '#/components/schemas/BrowserSigningConfigInput'
                enterprisePolicies:
                  type: array
                  items:
                    $ref: '#/components/schemas/BedrockAgentcoreControlBrowserEnterprisePolicy'
                  description: A list of enterprise policy files for the browser.
                certificates:
                  type: array
                  items:
                    $ref: '#/components/schemas/Certificate'
                  description: A list of certificates to install in the browser.
                filesystemConfigurations:
                  type: array
                  items:
                    $ref: '#/components/schemas/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
      tags:
      - Browsers
    post:
      operationId: ListBrowsers
      summary: List Browsers
      description: Lists all custom browsers in your account.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListBrowsersResponse'
        '403':
          description: AccessDeniedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '500':
          description: InternalServerException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '429':
          description: ThrottlingException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThrottlingException'
        '400':
          description: ValidationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BedrockAgentcoreControlValidationException'
      parameters:
      - name: maxResults
        in: query
        schema:
          type: integer
        description: The maximum number of results to return in a single call. The default value is 10. The maximum value
          is 50.
      - name: nextToken
        in: query
        schema:
          type: string
        description: The token for the next set of results. Use the value returned in the previous response in the next request
          to retrieve the next set of results.
      - name: type
        in: query
        schema:
          type: string
          enum:
          - SYSTEM
          - CUSTOM
        description: The type of browsers to list. If not specified, all browser types are returned.
      tags:
      - Browsers
  /browsers/{browserId}:
    get:
      operationId: GetBrowser
      summary: Get Browser
      description: Gets information about a custom browser.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBrowserResponse'
        '403':
          description: AccessDeniedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '500':
          description: InternalServerException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
        '402':
          description: ServiceQuotaExceededException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceQuotaExceededException'
        '429':
          description: ThrottlingException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThrottlingException'
      parameters:
      - name: browserId
        in: path
        required: true
        schema:
          type: string
        description: The unique identifier of the browser to retrieve.
      tags:
      - Browsers
    delete:
      operationId: DeleteBrowser
      summary: Delete Browser
      description: Deletes a custom browser.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteBrowserResponse'
        '403':
          description: AccessDeniedException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessDeniedException'
        '409':
          description: ConflictException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConflictException'
        '500':
          description: InternalServerException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerException'
        '404':
          description: ResourceNotFoundException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceNotFoundException'
        '402':
          description: ServiceQuotaExceededException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceQuotaExceededException'
        '429':
          description: ThrottlingException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ThrottlingException'
        '400':
          description: ValidationException
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BedrockAgentcoreControlValidationException'
      parameters:
      - name: browserId
        in: path
        required: true
        schema:
          type: string
        description: The unique identifier of the browser to delete.
      - name: clientToken
        in: query
        schema:
          type: string
        description: A unique, case-sensitive identifier to ensure idempotency of the request.
      tags:
      - Browsers
components:
  securitySchemes:
    sigv4:
      type: apiKey
      in: header
      name: Authorization
      description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical
        request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
      x-aws-sigv4:
        signingName: bedrock-agentcore
  schemas:
    AccessDeniedException:
      type: object
      properties:
        message:
          type: string
    BedrockAgentcoreControlBrowserEnterprisePolicy:
      type: object
      properties:
        location:
          $ref: '#/components/schemas/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: '#/components/schemas/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
    BedrockAgentcoreControlValidationException:
      type: object
      properties:
        message:
          type: string
        reason:
          type: string
          enum:
          - CannotParse
          - FieldValidationFailed
          - IdempotentParameterMismatchException
          - EventInOtherSession
          - ResourceConflict
        fieldList:
          type: array
          items:
            $ref: '#/components/schemas/ValidationExceptionField'
      required:
      - message
      - reason
    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: '#/components/schemas/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
    BrowserSigningConfigOutput:
      type: object
      properties:
        enabled:
          type: boolean
          description: Indicates whether browser signing is currently enabled for cryptographic agent identification using
            HTTP message signatures.
      required:
      - enabled
    BrowserSummary:
      type: object
      properties:
        browserId:
          type: string
          description: The unique identifier of the browser.
        browserArn:
          type: string
          description: The Amazon Resource Name (ARN) of the browser.
        name:
          type: string
          description: The name of the browser.
        description:
          type: string
          description: The description of the browser.
        status:
          type: string
          enum:
          - CREATING
          - CREATE_FAILED
          - READY
          - DELETING
          - DELETE_FAILED
          - DELETED
          description: The current status of the browser.
        createdAt:
          type: string
          format: date-time
          description: The timestamp when the browser was created.
        lastUpdatedAt:
          type: string
          format: date-time
          description: The timestamp when the browser was last updated.
      required:
      - browserId
      - browserArn
      - status
      - createdAt
    Certificate:
      type: object
      properties:
        location:
          $ref: '#/components/schemas/CertificateLocation'
      required:
      - location
    CertificateLocation:
      type: object
      properties:
        secretsManager:
          $ref: '#/components/schemas/SecretsManagerLocation'
      description: Exactly one member is set.
    ConflictException:
      type: object
      properties:
        message:
          type: string
    CreateBrowserResponse:
      type: object
      properties:
        browserId:
          type: string
          description: The unique identifier of the created browser.
        browserArn:
          type: string
          description: The Amazon Resource Name (ARN) of the created browser.
        createdAt:
          type: string
          format: date-time
          description: The timestamp when the browser was created.
        status:
          type: string
          enum:
          - CREATING
          - CREATE_FAILED
          - READY
          - DELETING
          - DELETE_FAILED
          - DELETED
          description: The current status of the browser.
      required:
      - browserId
      - browserArn
      - createdAt
      - status
    DeleteBrowserResponse:
      type: object
      properties:
        browserId:
          type: string
          description: The unique identifier of the deleted browser.
        status:
          type: string
          enum:
          - CREATING
          - CREATE_FAILED
          - READY
          - DELETING
          - DELETE_FAILED
          - DELETED
          description: The current status of the browser deletion.
        lastUpdatedAt:
          type: string
          format: date-time
          description: The timestamp when the browser was last updated.
      required:
      - browserId
      - status
      - lastUpdatedAt
    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
    GetBrowserResponse:
      type: object
      properties:
        browserId:
          type: string
          description: The unique identifier of the browser.
        browserArn:
          type: string
          description: The Amazon Resource Name (ARN) of the browser.
        name:
          type: string
          description: The name of the browser.
        description:
          type: string
          description: The description of the browser.
        executionRoleArn:
          type: string
          description: The IAM role ARN that provides permissions for the browser.
        networkConfiguration:
          $ref: '#/components/schemas/BrowserNetworkConfiguration'
        recording:
          $ref: '#/components/schemas/RecordingConfig'
        browserSigning:
          $ref: '#/components/schemas/BrowserSigningConfigOutput'
        enterprisePolicies:
          type: array
          items:
            $ref: '#/components/schemas/BedrockAgentcoreControlBrowserEnterprisePolicy'
          description: The list of enterprise policy files configured for the browser.
        certificates:
          type: array
          items:
            $ref: '#/components/schemas/Certificate'
          description: The list of certificates configured for the browser.
        filesystemConfigurations:
          type: array
          items:
            $ref: '#/components/schemas/ToolsFileSystemConfiguration'
          description: The file system configurations mounted into the browser. Each entry describes an access point and its
            mount path.
        status:
          type: string
          enum:
          - CREATING
          - CREATE_FAILED
          - READY
          - DELETING
          - DELETE_FAILED
          - DELETED
          description: The current status of the browser.
        failureReason:
          type: string
          description: The reason for failure if the browser is in a failed state.
        createdAt:
          type: string
          format: date-time
          description: The timestamp when the browser was created.
        lastUpdatedAt:
          type: string
          format: date-time
          description: The timestamp when the browser was last updated.
      required:
      - browserId
      - browserArn
      - name
      - networkConfiguration
      - status
      - createdAt
      - lastUpdatedAt
    InternalServerException:
      type: object
      properties:
        message:
          type: string
    ListBrowsersResponse:
      type: object
      properties:
        browserSummaries:
          type: array
          items:
            $ref: '#/components/schemas/BrowserSummary'
          description: The list of browser summaries.
        nextToken:
          type: string
          description: A token to retrieve the next page of results.
      required:
      - browserSummaries
    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: '#/components/schemas/BedrockAgentcoreControlS3Location'
    ResourceNotFoundException:
      type: object
      properties:
        message:
          type: string
    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
    ServiceQuotaExceededException:
      type: object
      properties:
        message:
          type: string
    ThrottlingException:
      type: object
      properties:
        message:
          type: string
    ToolsFileSystemConfiguration:
      type: object
      properties:
        s3FilesConfiguration:
          $ref: '#/components/schemas/S3FilesConfiguration'
        efsConfiguration:
          $ref: '#/components/schemas/EfsConfiguration'
      description: Exactly one member is set.
    ValidationExceptionField:
      type: object
      properties:
        name:
          type: string
          description: The name of the field.
        message:
          type: string
          description: A message describing why this field failed validation.
      required:
      - name
      - message
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/3cd98287b471c106254abd89279cc87308d38bfd/models/bedrock-agentcore-control/service/2023-06-05/bedrock-agentcore-control-2023-06-05.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)