Skip to main content
POST
https://agent.usedari.com
/
task
/
{org_id}
/
{endpoint_name}
/
start
curl -X POST https://agent.usedari.com/task/my-org/contact_form/start \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "form_data": {
      "firstName": "Jane",
      "lastName": "Smith",
      "email": "[email protected]"
    },
    "fast_mode": false,
    "max_turns": 100,
    "timeout_minutes": 30
  }'

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "browser_url": "https://hyperbrowser.ai/view/abc123"
}
Starts an AI-powered browser automation job. The agent navigates to the portal’s start URL and fills the form with the provided data.

​
Path Parameters

​
org_id
string
required
Organization ID
​
endpoint_name
string
required
Portal endpoint name

​
Headers

​
X-API-Key
string
required
Organization API key
​
Content-Type
string
required
Must be application/json

​
Request Body

​
form_data
object
Key-value pairs matching the portal’s form_schema. The AI agent uses this data to fill the target form. Only required if the portal has a form_schema defined.
​
fast_mode
boolean
default:false
Use a faster, cheaper model (Claude Haiku) instead of the default (Claude Sonnet). Trades quality for speed and cost.
​
max_turns
integer
default:200
Maximum number of agent turns before stopping
​
timeout_minutes
integer
default:30
Maximum execution time in minutes
​
profile_id
string
Browser profile UUID to use for this job. Overrides the portal’s configured profile.
​
proxy
object
Proxy configuration for the browser session

​
Response Fields

​
job_id
string
UUID of the created job. Use this to poll status, stream logs, or control the job.
​
browser_url
string
Live browser URL to watch the agent work in real-time
curl -X POST https://agent.usedari.com/task/my-org/contact_form/start \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "form_data": {
      "firstName": "Jane",
      "lastName": "Smith",
      "email": "[email protected]"
    },
    "fast_mode": false,
    "max_turns": 100,
    "timeout_minutes": 30
  }'

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "browser_url": "https://hyperbrowser.ai/view/abc123"
}

​
Usage Notes

  • Jobs run asynchronously. Use Get Job Status to poll or Stream Job Logs for real-time updates.
  • Each job consumes credits based on execution time and model used.
  • The browser_url allows you to watch the agent navigate and fill forms in real-time.
  • Use profile_id to leverage saved login sessions across jobs.