Skip to main content
POST
https://agent.usedari.com
/
profiles
/
{org_id}
curl -X POST https://agent.usedari.com/profiles/my-org \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Gmail Login",
    "timeout_minutes": 15
  }'

{
  "profile_id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Gmail Login",
  "live_url": "https://hyperbrowser.ai/view/abc123",
  "session_id": "sess_xyz789"
}
Creates a new browser profile and opens a live session. Use the live_url to manually log in to websites, then close the session to save the authenticated state.

​
Path Parameters

​
org_id
string
required
Organization ID

​
Headers

​
X-API-Key
string
required
Organization API key

​
Request Body

​
name
string
Profile name (auto-generated if not provided)
​
profile_id
string
Existing profile ID to open a new session for
​
timeout_minutes
integer
default:10
Session timeout in minutes
​
use_proxy
boolean
default:false
Enable proxy for the session

​
Response Fields

​
profile_id
string
UUID of the profile
​
name
string
Profile name
​
live_url
string
URL to open the browser for manual interaction (e.g., logging in)
​
session_id
string
Session ID for closing the session later
curl -X POST https://agent.usedari.com/profiles/my-org \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Gmail Login",
    "timeout_minutes": 15
  }'

{
  "profile_id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Gmail Login",
  "live_url": "https://hyperbrowser.ai/view/abc123",
  "session_id": "sess_xyz789"
}

​
Usage Notes

  • Open the live_url in your browser to manually log in or configure the profile
  • Close the session via Close Profile Session to save the state
  • Attach profiles to portals or pass them to jobs via profile_id