Skip to main content
POST
/
api
/
task
/
hyper-agent
JavaScript
import { Hyperbrowser } from '@hyperbrowser/sdk';

const client = new Hyperbrowser({ apiKey: 'your-api-key' });

await client.agents.hyperAgent.start({
  task: 'Find the price of the product',
  maxSteps: 20
});
{
  "jobId": "<string>",
  "liveUrl": "<string>"
}

Authorizations

x-api-key
string
header
required

Body

application/json
task
string
required
version
enum<string>
default:0.8.0
Available options:
0.8.0,
1.1.0
llm
enum<string>
default:gpt-4o
Available options:
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-5,
gemini-2.5-flash
sessionId
string
maxSteps
number
default:20
keepBrowserOpen
boolean
default:false
sessionOptions
object
useCustomApiKeys
boolean
default:false
apiKeys
object

Response

HyperAgent task started successfully

jobId
string
required
liveUrl
string | null