v2

latestOpenAPI 3.0.12026-07-2658122198.9 KB

Start a HyperAgent task

post/api/task/hyper-agent

Request body

taskstring required
version'0.8.0' | '1.1.0'
llm'gpt-5.6-luna' | 'gpt-5.5' | '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-5' | 'claude-sonnet-4-6' | 'claude-sonnet-4-5' | 'gemini-2.5-flash' | 'gemini-3-flash-preview'
sessionIdstring
maxStepsnumber
keepBrowserOpenboolean
useCustomApiKeysboolean

Example request

{
  "sessionOptions": {
    "proxyCity": "new york"
  }
}

Response

HyperAgent task started successfully

jobIdstring required
liveUrlstring nullable