Skip to main content
POST
https://api.usedari.com
/
public
/
browser-profiles
from dari import Dari

client = Dari(api_key="YOUR_API_KEY")

# Create a browser profile
profile = client.create_browser_profile(
    name="linkedin-profile"
)

print(f"Profile ID: {profile['id']}")

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "linkedin-profile",
  "created_at": "2025-11-30T12:00:00Z"
}
Create a browser profile that can be reused across multiple workflow executions to maintain authentication state, cookies, and browser data.

​
Headers

​
X-API-Key
string
required
Your API key for authentication
​
Content-Type
string
required
Must be application/json

​
Request Body

​
name
string
required
A unique name for the browser profile
​
provider
string
Browser provider to use: hyperbrowser or kernel. Defaults to hyperbrowser

​
Response Fields

​
id
string
Unique identifier (UUID) for the created browser profile
​
name
string
The name of the browser profile
​
created_at
string
ISO 8601 timestamp when the profile was created
from dari import Dari

client = Dari(api_key="YOUR_API_KEY")

# Create a browser profile
profile = client.create_browser_profile(
    name="linkedin-profile"
)

print(f"Profile ID: {profile['id']}")

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "linkedin-profile",
  "created_at": "2025-11-30T12:00:00Z"
}

​
Usage Notes

  • Profile names must be unique within your workspace
  • After creating a profile, use Create Session with the profile ID to set up authentication
  • Open the session’s live_url in your browser to manually log in to websites
  • Once logged in, terminate the session to save the authentication state to the profile
  • Use the profile in Start Workflow to run workflows with persistent authentication

​
Error Responses

{
  "detail": "Invalid API key"
}

{
  "detail": "Profile name already exists"
}