Hyperbrowser

Hyperbrowser Agents API

Start, stop, and monitor agentic browser tasks across HyperAgent, Browser-Use, Claude Computer Use, Gemini Computer Use, and OpenAI's CUA. Each task runs inside a stealth Hyperbrowser session with live-view URL, proxy support, and CAPTCHA solving.

GitHub OpenAPI

Operations 20

POST /api/task/hyper-agent Start a HyperAgent Task #
GET /api/task/hyper-agent/{id} Get HyperAgent Task Status and Results #
PUT /api/task/hyper-agent/{id}/stop Stop a HyperAgent Task #
GET /api/task/hyper-agent/{id}/status Get HyperAgent Task Status #
POST /api/task/browser-use Start a Browser Use Task #
GET /api/task/browser-use/{id} Get Browser Use Task Status and Results #
PUT /api/task/browser-use/{id}/stop Stop a Browser Use Task #
GET /api/task/browser-use/{id}/status Get Browser Use Task Status #
POST /api/task/claude-computer-use Start a Claude Computer Use Task #
GET /api/task/claude-computer-use/{id} Get Claude Computer Use Task Status and Results #
PUT /api/task/claude-computer-use/{id}/stop Stop a Claude Computer Use Task #
GET /api/task/claude-computer-use/{id}/status Get Claude Computer Use Task Status #
POST /api/task/gemini-computer-use Start a Gemini Computer Use Task #
GET /api/task/gemini-computer-use/{id} Get Gemini Computer Use Task Status and Results #
PUT /api/task/gemini-computer-use/{id}/stop Stop a Gemini Computer Use Task #
GET /api/task/gemini-computer-use/{id}/status Get Gemini Computer Use Task Status #
POST /api/task/cua Start a CUA Task #
GET /api/task/cua/{id} Get CUA Task Status and Results #
PUT /api/task/cua/{id}/stop Stop a CUA Task #
GET /api/task/cua/{id}/status Get CUA Task Status #

Documentation

📖
Documentation
https://docs.hyperbrowser.ai/agents/overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/hyperbrowser/refs/heads/main/openapi/hyperbrowser-agents-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/hyperbrowser/refs/heads/main/json-schema/hyperbrowser-agent-task-schema.json

Other Resources

🔗
Examples
https://raw.githubusercontent.com/api-evangelist/hyperbrowser/refs/heads/main/examples/hyperbrowser-claude-computer-use-example.json

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/agents-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

hyperbrowser-agents-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Hyperbrowser Agents API
  version: 1.0.0
  description: Start, stop, and monitor agentic browser tasks across HyperAgent, Browser-Use, Claude Computer Use, Gemini Computer Use, and OpenAI CUA.
  contact:
    name: Hyperbrowser
    url: https://hyperbrowser.ai
  license:
    name: Hyperbrowser Terms
    url: https://hyperbrowser.ai/terms
servers:
- url: https://api.hyperbrowser.ai
  description: Production server
security:
- ApiKeyAuth: []
tags:
- name: Agents
paths:
  /api/task/hyper-agent:
    post:
      operationId: post-api-task-hyper-agent
      summary: Start a HyperAgent Task
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartHyperAgentTaskParams'
      responses:
        '200':
          description: HyperAgent task started successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StartHyperAgentTaskResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/hyper-agent/{id}:
    get:
      operationId: get-api-task-hyper-agent-id
      summary: Get HyperAgent Task Status and Results
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: HyperAgent task details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HyperAgentTaskResponse'
        '404':
          description: HyperAgent task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/hyper-agent/{id}/stop:
    put:
      operationId: put-api-task-hyper-agent-id-stop
      summary: Stop a HyperAgent Task
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: HyperAgent task stopped successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BasicResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/hyper-agent/{id}/status:
    get:
      operationId: get-api-task-hyper-agent-id-status
      summary: Get HyperAgent Task Status
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: HyperAgent task status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobStatusResponse'
        '404':
          description: HyperAgent task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/browser-use:
    post:
      operationId: post-api-task-browser-use
      summary: Start a Browser Use Task
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartBrowserUseTaskParams'
      responses:
        '200':
          description: Browser use task started successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StartBrowserUseTaskResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/browser-use/{id}:
    get:
      operationId: get-api-task-browser-use-id
      summary: Get Browser Use Task Status and Results
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Browser use task details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BrowserUseTaskResponse'
        '404':
          description: Browser use task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/browser-use/{id}/stop:
    put:
      operationId: put-api-task-browser-use-id-stop
      summary: Stop a Browser Use Task
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Browser use task stopped successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BasicResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/browser-use/{id}/status:
    get:
      operationId: get-api-task-browser-use-id-status
      summary: Get Browser Use Task Status
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Browser use task status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobStatusResponse'
        '404':
          description: Browser use task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/claude-computer-use:
    post:
      operationId: post-api-task-claude-computer-use
      summary: Start a Claude Computer Use Task
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartClaudeComputerUseTaskParams'
      responses:
        '200':
          description: Claude computer use task started successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StartClaudeComputerUseTaskResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/claude-computer-use/{id}:
    get:
      operationId: get-api-task-claude-computer-use-id
      summary: Get Claude Computer Use Task Status and Results
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Claude computer use task details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClaudeComputerUseTaskResponse'
        '404':
          description: Claude computer use task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/claude-computer-use/{id}/stop:
    put:
      operationId: put-api-task-claude-computer-use-id-stop
      summary: Stop a Claude Computer Use Task
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Claude computer use task stopped successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BasicResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/claude-computer-use/{id}/status:
    get:
      operationId: get-api-task-claude-computer-use-id-status
      summary: Get Claude Computer Use Task Status
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Claude computer use task status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobStatusResponse'
        '404':
          description: Claude computer use task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/gemini-computer-use:
    post:
      operationId: post-api-task-gemini-computer-use
      summary: Start a Gemini Computer Use Task
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartGeminiComputerUseTaskParams'
      responses:
        '200':
          description: Gemini computer use task started successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StartGeminiComputerUseTaskResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/gemini-computer-use/{id}:
    get:
      operationId: get-api-task-gemini-computer-use-id
      summary: Get Gemini Computer Use Task Status and Results
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Gemini computer use task details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeminiComputerUseTaskResponse'
        '404':
          description: Gemini computer use task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/gemini-computer-use/{id}/stop:
    put:
      operationId: put-api-task-gemini-computer-use-id-stop
      summary: Stop a Gemini Computer Use Task
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Gemini computer use task stopped successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BasicResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/gemini-computer-use/{id}/status:
    get:
      operationId: get-api-task-gemini-computer-use-id-status
      summary: Get Gemini Computer Use Task Status
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Gemini computer use task status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobStatusResponse'
        '404':
          description: Gemini computer use task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/cua:
    post:
      operationId: post-api-task-cua
      summary: Start a CUA Task
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StartCuaTaskParams'
      responses:
        '200':
          description: CUA task started successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StartCuaTaskResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/cua/{id}:
    get:
      operationId: get-api-task-cua-id
      summary: Get CUA Task Status and Results
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: CUA task details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CuaTaskResponse'
        '404':
          description: CUA task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/cua/{id}/stop:
    put:
      operationId: put-api-task-cua-id-stop
      summary: Stop a CUA Task
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: CUA task stopped successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BasicResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
  /api/task/cua/{id}/status:
    get:
      operationId: get-api-task-cua-id-status
      summary: Get CUA Task Status
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: CUA task status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobStatusResponse'
        '404':
          description: CUA task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - ApiKeyAuth: []
      tags:
      - Agents
components:
  schemas:
    HyperAgentLlm:
      type: string
      enum:
      - gpt-5.2
      - gpt-5.1
      - gpt-5
      - gpt-5-mini
      - gpt-4o
      - gpt-4o-mini
      - gpt-4.1
      - gpt-4.1-mini
      - claude-sonnet-4-6
      - claude-sonnet-4-5
      - gemini-2.5-flash
      - gemini-3-flash-preview
      default: gpt-4o
    StartBrowserUseTaskResponse:
      type: object
      properties:
        jobId:
          type: string
        liveUrl:
          type:
          - string
          - 'null'
      required:
      - jobId
    ClaudeComputerUseLlm:
      type: string
      enum:
      - claude-opus-4-5
      - claude-opus-4-6
      - claude-haiku-4-5-20251001
      - claude-sonnet-4-6
      - claude-sonnet-4-5
      - claude-sonnet-4-20250514
      default: claude-sonnet-4-5
    Device:
      type: string
      enum:
      - desktop
      - mobile
    StartHyperAgentTaskParams:
      type: object
      properties:
        task:
          type: string
        version:
          $ref: '#/components/schemas/HyperAgentVersion'
        llm:
          $ref: '#/components/schemas/HyperAgentLlm'
        sessionId:
          type: string
        maxSteps:
          type: number
          default: 20
        keepBrowserOpen:
          type: boolean
          default: false
        sessionOptions:
          $ref: '#/components/schemas/CreateSessionParams'
        useCustomApiKeys:
          type: boolean
          default: false
        apiKeys:
          type: object
          properties:
            openai:
              type: string
            anthropic:
              type: string
            google:
              type: string
      required:
      - task
      default:
        task: go to example.com
    BrowserUseVersion:
      type: string
      enum:
      - 0.1.40
      - 0.7.10
      - latest
      default: 0.1.40
    CuaTaskResponse:
      type: object
      properties:
        jobId:
          type: string
        status:
          $ref: '#/components/schemas/JobStatus'
        data:
          type: object
          properties:
            steps:
              type: array
              items:
                type: object
            finalResult:
              type:
              - string
              - 'null'
        error:
          type:
          - string
          - 'null'
        liveUrl:
          type:
          - string
          - 'null'
      required:
      - jobId
      - status
    ClaudeComputerUseTaskResponse:
      type: object
      properties:
        jobId:
          type: string
        status:
          $ref: '#/components/schemas/JobStatus'
        data:
          type: object
          properties:
            steps:
              type: array
              items:
                type: object
            finalResult:
              type:
              - string
              - 'null'
        error:
          type:
          - string
          - 'null'
        liveUrl:
          type:
          - string
          - 'null'
      required:
      - jobId
      - status
    BrowserUseLlm:
      type: string
      enum:
      - gpt-4o
      - gpt-4o-mini
      - gpt-4.1
      - gpt-4.1-mini
      - claude-sonnet-4-6
      - claude-sonnet-4-5
      - claude-sonnet-4-20250514
      - gemini-2.0-flash
      - gemini-2.5-flash
      default: gemini-2.0-flash
    BrowserUseTaskResponse:
      type: object
      properties:
        jobId:
          type: string
        status:
          $ref: '#/components/schemas/JobStatus'
        data:
          type: object
          properties:
            steps:
              type: array
              items:
                type: object
            finalResult:
              type:
              - string
              - 'null'
        error:
          type:
          - string
          - 'null'
        liveUrl:
          type:
          - string
          - 'null'
      required:
      - jobId
      - status
    GeminiComputerUseTaskResponse:
      type: object
      properties:
        jobId:
          type: string
        status:
          $ref: '#/components/schemas/JobStatus'
        data:
          type: object
          properties:
            steps:
              type: array
              items:
                type: object
            finalResult:
              type:
              - string
              - 'null'
        error:
          type:
          - string
          - 'null'
        liveUrl:
          type:
          - string
          - 'null'
      required:
      - jobId
      - status
    HyperAgentVersion:
      type: string
      enum:
      - 0.8.0
      - 1.1.0
      default: 0.8.0
    StartGeminiComputerUseTaskParams:
      type: object
      properties:
        task:
          type: string
        llm:
          $ref: '#/components/schemas/GeminiComputerUseLlm'
        sessionId:
          type: string
        maxFailures:
          type: number
          default: 3
        maxSteps:
          type: number
          default: 20
        keepBrowserOpen:
          type: boolean
          default: false
        sessionOptions:
          $ref: '#/components/schemas/CreateSessionParams'
        useCustomApiKeys:
          type: boolean
          default: false
        apiKeys:
          type: object
          properties:
            google:
              type: string
        useComputerAction:
          type: boolean
          default: false
      required:
      - task
      default:
        task: go to example.com
    OperatingSystem:
      type: string
      enum:
      - windows
      - android
      - macos
      - linux
      - ios
    ProxyState:
      type:
      - string
      - 'null'
      enum:
      - AL
      - AK
      - AZ
      - AR
      - CA
      - CO
      - CT
      - DE
      - FL
      - GA
      - HI
      - ID
      - IL
      - IN
      - IA
      - KS
      - KY
      - LA
      - ME
      - MD
      - MA
      - MI
      - MN
      - MS
      - MO
      - MT
      - NE
      - NV
      - NH
      - NJ
      - NM
      - NY
      - NC
      - ND
      - OH
      - OK
      - OR
      - PA
      - RI
      - SC
      - SD
      - TN
      - TX
      - UT
      - VT
      - VA
      - WA
      - WV
      - WI
      - WY
      - al
      - ak
      - az
      - ar
      - ca
      - co
      - ct
      - de
      - fl
      - ga
      - hi
      - id
      - il
      - in
      - ia
      - ks
      - ky
      - la
      - me
      - md
      - ma
      - mi
      - mn
      - ms
      - mo
      - mt
      - ne
      - nv
      - nh
      - nj
      - nm
      - ny
      - nc
      - nd
      - oh
      - ok
      - or
      - pa
      - ri
      - sc
      - sd
      - tn
      - tx
      - ut
      - vt
      - va
      - wa
      - wv
      - wi
      - wy
      description: Optional state code for proxies to US states. Is mutually exclusive with proxyCity. Takes in two letter state code.
    StartCuaTaskParams:
      type: object
      properties:
        task:
          type: string
        llm:
          $ref: '#/components/schemas/CuaLlm'
        sessionId:
          type: string
        maxFailures:
          type: number
          default: 3
        maxSteps:
          type: number
          default: 20
        keepBrowserOpen:
          type: boolean
          default: false
        sessionOptions:
          $ref: '#/components/schemas/CreateSessionParams'
        useCustomApiKeys:
          type: boolean
          default: false
        apiKeys:
          type: object
          properties:
            openai:
              type: string
        useComputerAction:
          type: boolean
          default: false
      required:
      - task
      default:
        task: go to example.com
    GeminiComputerUseLlm:
      type: string
      enum:
      - gemini-3-flash-preview
      - gemini-2.5-computer-use-preview-10-2025
      default: gemini-3-flash-preview
    HyperAgentTaskResponse:
      type: object
      properties:
        jobId:
          type: string
        status:
          $ref: '#/components/schemas/JobStatus'
        data:
          type: object
          properties:
            steps:
              type: array
              items:
                type: object
            finalResult:
              type:
              - string
              - 'null'
        error:
          type:
          - string
          - 'null'
        liveUrl:
          type:
          - string
          - 'null'
      required:
      - jobId
      - status
    ProxyCountry:
      type: string
      enum:
      - AD
      - AE
      - AF
      - AL
      - AM
      - AO
      - AR
      - AT
      - AU
      - AW
      - AZ
      - BA
      - BD
      - BE
      - BG
      - BH
      - BJ
      - BO
      - BR
      - BS
      - BT
      - BY
      - BZ
      - CA
      - CF
      - CH
      - CI
      - CL
      - CM
      - CN
      - CO
      - CR
      - CU
      - CY
      - CZ
      - DE
      - DJ
      - DK
      - DM
      - EC
      - EE
      - EG
      - ES
      - ET
      - EU
      - FI
      - FJ
      - FR
      - GB
      - GE
      - GH
      - GM
      - GR
      - HK
      - HN
      - HR
      - HT
      - HU
      - ID
      - IE
      - IL
      - IN
      - IQ
      - IR
      - IS
      - IT
      - JM
      - JO
      - JP
      - KE
      - KH
      - KR
      - KW
      - KZ
      - LB
      - LI
      - LR
      - LT
      - LU
      - LV
      - MA
      - MC
      - MD
      - ME
      - MG
      - MK
      - ML
      - MM
      - MN
      - MR
      - MT
      - MU
      - MV
      - MX
      - MY
      - MZ
      - NG
      - NL
      - 'NO'
      - NZ
      - OM
      - PA
      - PE
      - PH
      - PK
      - PL
      - PR
      - PT
      - PY
      - QA
      - RANDOM_COUNTRY
      - RO
      - RS
      - RU
      - SA
      - SC
      - SD
      - SE
      - SG
      - SI
      - SK
      - SN
      - SS
      - TD
      - TG
      - TH
      - TM
      - TN
      - TR
      - TT
      - TW
      - UA
      - UG
      - US
      - UY
      - UZ
      - VE
      - VG
      - VN
      - YE
      - ZA
      - ZM
      - ZW
      - ad
      - ae
      - af
      - al
      - am
      - ao
      - ar
      - at
      - au
      - aw
      - az
      - ba
      - bd
      - be
      - bg
      - bh
      - bj
      - bo
      - br
      - bs
      - bt
      - by
      - bz
      - ca
      - cf
      - ch
      - ci
      - cl
      - cm
      - cn
      - co
      - cr
      - cu
      - cy
      - cz
      - de
      - dj
      - dk
      - dm
      - ec
      - ee
      - eg
      - es
      - et
      - eu
      - fi
      - fj
      - fr
      - gb
      - ge
      - gh
      - gm
      - gr
      - hk
      - hn
      - hr
      - ht
      - hu
      - id
      - ie
      - il
      - in
      - iq
      - ir
      - is
      - it
      - jm
      - jo
      - jp
      - ke
      - kh
      - kr
      - kw
      - kz
      - lb
      - li
      - lr
      - lt
      - lu
      - lv
      - ma
      - mc
      - md
      - me
      - mg
      - mk
      - ml
      - mm
      - mn
      - mr
      - mt
      - mu
      - mv
      - mx
      - my
      - mz
      - ng
      - nl
      - 'no'
      - nz
      - om
      - pa
      - pe
      - ph
      - pk
      - pl
      - pr
      - pt
      - py
      - qa
      - ro
      - rs
      - ru
      - sa
      - sc
      - sd
      - se
      - sg
      - si
      - sk
      - sn
      - ss
      - td
      - tg
      - th
      - tm
      - tn
      - tr
      - tt
      - tw
      - ua
      - ug
      - us
      - uy
      - uz
      - ve
      - vg
      - vn
      - ye
      - za
      - zm
      - zw
    StartBrowserUseTaskParams:
      type: object
      properties:
        task:
          type: string
        version:
          $ref: '#/components/schemas/BrowserUseVersion'
        llm:
          $ref: '#/components/schemas/BrowserUseLlm'
        sessionId:
          type: string
        validateOutput:
          type: boolean
          default: false
        useVision:
          type: boolean
          default: true
        useVisionForPlanner:
          type: boolean
          default: false
        maxActionsPerStep:
          type: number
          default: 10
        maxInputTokens:
          type: number
          default: 128000
        plannerLlm:
          $ref: '#/components/schemas/BrowserUseLlm'
        pageExtractionLlm:
          $ref: '#/components/schemas/BrowserUseLlm'
        plannerInterval:
          type: number
          default: 10
        maxSteps:
          type: number
          default: 20
        maxFailures:
          type: number
          default: 3
        initialActions:
          type: array
          items:
            type: object
            additionalProperties:
              type: object
              additionalProperties: true
        sensitiveData:
          type: object
          additionalProperties:
            type: string
        messageContext:
          type: string
        keepBrowserOpen:
          type: boolean
          default: false
        sessionOptions:
          $ref: '#/components/schemas/CreateSessionParams'
        useCustomApiKeys:
          type: boolean
          default: false
        apiKeys:
          type: object
          properties:
            openai:
              type: string
            anthropic:
              type: string
            google:
              type: string
      required:
      - task
      default:
        task: go to example.com
    JobStatusResponse:
      type: object
      properties:
        status:
          $ref: '#/components/schemas/JobStatus'
      required:
      - status
    StartClaudeComputerUseTaskParams:
      type: object
      properties:
        task:
          type: string
        llm:
          $ref: '#/components/schemas/ClaudeComputerUseLlm'
        sessionId:
          type: string
        maxFailures:
          type: number
          default: 3
        maxSteps:
          type: number
          default: 20
        keepBrowserOpen:
          type: boolean
          default: false
        sessionOptions:
          $ref: '#/components/schemas/CreateSessionParams'
        useCustomApiKeys:
          type: boolean
          default: false
        apiKeys:
          type: object
          properties:
            anthropic:
              type: string
        useComputerAction:
          type: boolean
          default: false
      required:
      - task
      default:
        task: go to example.com
    StartClaudeComputerUseTaskResponse:
      type: object
      properties:
        jobId:
          type: string
        liveUrl:
          type:
          - string
          - 'null'
      required:
      - jobId
    StartHyperAgentTaskResponse:
      type: object
      properties:
        jobId:
          type: string
        liveUrl:
          type:
          - string
          - 'null'
      required:
      - jobId
    StartCuaTaskResponse:
      type: object
      properties:
        jobId:
          type: string
        liveUrl:
          type:
          - string
          - 'null'
      required:
      - jobId
    ErrorResponse:
      type: object
      properties:
        message:
          type: string
    CreateSessionParams:
      type: object
      properties:
        useUltraStealth:
          type: boolean
          default: false
        useStealth:
          type: boolean
          default: false
        useProxy:
          type: boolean
          default: false
        proxyServer:
          type: string
        proxyServerPassword:
          type: string
        proxyServerUsername:
          type: string
        proxyCountry:
          $ref: '#/components/schemas/ProxyCountry'
        proxyState:
          $ref: '#/components/schemas/ProxyState'
        proxyCity:
          type:
          - string
          - 'null'
          example: new york
          description: Desired Country. Is mutually exclusive with proxyState. Some cities might not be supported, so before using a new city, we recommend trying it out
        region:
          $ref: '#/components/schemas/SessionRegion'
        operatingSystems:
          type: array
          items:
            $ref: '#/components/schemas/OperatingSystem'
        device:
          type: array
        

# --- truncated at 32 KB (38 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/hyperbrowser/refs/heads/main/openapi/hyperbrowser-agents-api-openapi.yml