Skip to main content
PUT
/
api
/
v2
/
browser-profiles
/
{profile_id}
/
default
Set the default browser profile
curl --request PUT \
  --url https://agp.eu.hcompany.ai/api/v2/browser-profiles/{profile_id}/default \
  --header 'Authorization: Bearer <token>'
Marks a profile as your default for its browser_name. Sessions created with use_default_browser_profile: true on the Browser environment load this profile. You have at most one default per browser, so setting a new default replaces the previous one for the same browser_name — no need to unset it first. Returns the updated profile object with is_default: true.

​
Path parameters

​
profile_id
string
required
The profile’s id (UUID).

​
Examples

curl -X PUT "https://agp.eu.hcompany.ai/api/v2/browser-profiles/a1b2c3d4-5678-90ab-cdef-1234567890ab/default" \
  -H "Authorization: Bearer $HAI_API_KEY"
Response
{
  "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "name": "acme-prod-login",
  "description": null,
  "browser_name": "chromium",
  "browser_version": "131",
  "s3_path": "browser-profiles/finished/org_123/a1b2c3d4-5678-90ab-cdef-1234567890ab/profile.zip",
  "file_size_bytes": 102400,
  "checksum": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
  "usage_count": 3,
  "last_used_at": "2026-06-16T13:05:00Z",
  "labels": {"team": "qa"},
  "is_default": true,
  "created_at": "2026-06-16T14:30:00Z",
  "updated_at": "2026-07-08T09:00:00Z"
}

​
Errors

StatusCause
404Profile not found or you don’t have access.