Claude Computer Use

Start a claude computer use task

post

Authorizations

Body

taskstringrequired

sessionIdstringoptional

maxFailuresnumber · default: 3optional

maxStepsnumber · default: 20optional

keepBrowserOpenboolean · default: falseoptional

sessionOptionsobject · default: {"useStealth":false,"useProxy":false,"acceptCookies":false}optional

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://app.hyperbrowser.ai/api/task/claude-computer-use' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "task": "text",
    "sessionId": "text",
    "maxFailures": 1,
    "maxSteps": 1,
    "keepBrowserOpen": true,
    "sessionOptions": {
      "useStealth": true,
      "useProxy": true,
      "proxyServer": "text",
      "proxyServerPassword": "text",
      "proxyServerUsername": "text",
      "proxyCountry": "US",
      "proxyState": "AL",
      "proxyCity": "new york",
      "operatingSystems": [
        "windows"
      ],
      "device": [
        "desktop"
      ],
      "platform": [
        "chrome"
      ],
      "locales": [
        "en"
      ],
      "screen": {
        "width": 1,
        "height": 1
      },
      "solveCaptchas": true,
      "adblock": true,
      "trackers": true,
      "annoyances": true,
      "enableWebRecording": true,
      "profile": {
        "id": "text",
        "persistChanges": true
      },
      "acceptCookies": true,
      "extensionIds": [
        "123e4567-e89b-12d3-a456-426614174000"
      ],
      "urlBlocklist": [
        "text"
      ],
      "browserArgs": [
        "text"
      ],
      "imageCaptchaParams": [
        {
          "imageSelector": "text",
          "inputSelector": "text"
        }
      ]
    }
  }'

200

500

200

{
  "jobId": "text",
  "liveUrl": "text"
}

Claude computer use task started successfully

Get claude computer use task status and results

get

Authorizations

Path parameters

idstringrequired

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://app.hyperbrowser.ai/api/task/claude-computer-use/{id}' \
  --header 'x-api-key: YOUR_API_KEY'

200

404

500

200

{
  "jobId": "text",
  "status": "pending",
  "data": {
    "steps": [
      {}
    ],
    "finalResult": "text"
  },
  "error": "text",
  "liveUrl": "text"
}

Claude computer use task details

Stop a claude computer use task

put

Authorizations

Path parameters

idstringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://app.hyperbrowser.ai/api/task/claude-computer-use/{id}/stop' \
  --header 'x-api-key: YOUR_API_KEY'

200

200

{
  "success": true
}

Claude computer use task stopped successfully

Get claude computer use task status

get

Authorizations

Path parameters

idstringrequired

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://app.hyperbrowser.ai/api/task/claude-computer-use/{id}/status' \
  --header 'x-api-key: YOUR_API_KEY'

200

404

500

200

{
  "status": "pending"
}

Claude computer use task status