Browser profiles
List browser profiles
List your organization’s browser profiles.
GET
/
api
/
v2
/
browser-profiles
from hai_agents import Client
client = Client()
page = client.browser_profiles.list_browser_profiles(limit=10, offset=0)
for profile in page.profiles:
print(profile.id, profile.name)
import { HaiAgentsClient } from "hai-agents";
const client = new HaiAgentsClient();
const page = await client.browserProfiles.listBrowserProfiles({ limit: 10, offset: 0 });
for (const profile of page.profiles) {
console.log(profile.id, profile.name);
}
curl "https://agp.eu.hcompany.ai/api/v2/browser-profiles?limit=10&offset=0" \
-H "Authorization: Bearer $HAI_API_KEY"
{
"total": 1,
"limit": 10,
"offset": 0,
"profiles": [
{
"id": "9b2e4c1a-7d3f-4e8b-a6c5-2f1d0e9b8a76",
"user_id": "5e6f7a8b-9c0d-4e1f-a2b3-c4d5e6f7a8b9",
"org_id": "1c9a2f6e-4b3d-4a8c-9e5f-7d6b8a0c1e2f",
"name": "acme-prod-login",
"description": null,
"browser_name": "chromium",
"browser_version": "150",
"file_size_bytes": 102400,
"checksum": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
"usage_count": 3,
"last_used_at": "2026-06-16T13:05:00Z",
"labels": {"team": "qa"},
"is_default": false,
"created_at": "2026-06-16T14:30:00Z",
"updated_at": "2026-06-16T14:30:00Z"
}
]
}
Query parameters
integer
default:"10"
Maximum number of profiles to return. Between
1 and 1000.integer
default:"0"
Number of profiles to skip before collecting the page.
Response
200 with total, limit, offset, and a profiles array of
profile objects.
Auto-created default profiles are named default-<browser>-....
from hai_agents import Client
client = Client()
page = client.browser_profiles.list_browser_profiles(limit=10, offset=0)
for profile in page.profiles:
print(profile.id, profile.name)
import { HaiAgentsClient } from "hai-agents";
const client = new HaiAgentsClient();
const page = await client.browserProfiles.listBrowserProfiles({ limit: 10, offset: 0 });
for (const profile of page.profiles) {
console.log(profile.id, profile.name);
}
curl "https://agp.eu.hcompany.ai/api/v2/browser-profiles?limit=10&offset=0" \
-H "Authorization: Bearer $HAI_API_KEY"
{
"total": 1,
"limit": 10,
"offset": 0,
"profiles": [
{
"id": "9b2e4c1a-7d3f-4e8b-a6c5-2f1d0e9b8a76",
"user_id": "5e6f7a8b-9c0d-4e1f-a2b3-c4d5e6f7a8b9",
"org_id": "1c9a2f6e-4b3d-4a8c-9e5f-7d6b8a0c1e2f",
"name": "acme-prod-login",
"description": null,
"browser_name": "chromium",
"browser_version": "150",
"file_size_bytes": 102400,
"checksum": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
"usage_count": 3,
"last_used_at": "2026-06-16T13:05:00Z",
"labels": {"team": "qa"},
"is_default": false,
"created_at": "2026-06-16T14:30:00Z",
"updated_at": "2026-06-16T14:30:00Z"
}
]
}
Was this page helpful?
⌘I
from hai_agents import Client
client = Client()
page = client.browser_profiles.list_browser_profiles(limit=10, offset=0)
for profile in page.profiles:
print(profile.id, profile.name)
import { HaiAgentsClient } from "hai-agents";
const client = new HaiAgentsClient();
const page = await client.browserProfiles.listBrowserProfiles({ limit: 10, offset: 0 });
for (const profile of page.profiles) {
console.log(profile.id, profile.name);
}
curl "https://agp.eu.hcompany.ai/api/v2/browser-profiles?limit=10&offset=0" \
-H "Authorization: Bearer $HAI_API_KEY"
{
"total": 1,
"limit": 10,
"offset": 0,
"profiles": [
{
"id": "9b2e4c1a-7d3f-4e8b-a6c5-2f1d0e9b8a76",
"user_id": "5e6f7a8b-9c0d-4e1f-a2b3-c4d5e6f7a8b9",
"org_id": "1c9a2f6e-4b3d-4a8c-9e5f-7d6b8a0c1e2f",
"name": "acme-prod-login",
"description": null,
"browser_name": "chromium",
"browser_version": "150",
"file_size_bytes": 102400,
"checksum": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
"usage_count": 3,
"last_used_at": "2026-06-16T13:05:00Z",
"labels": {"team": "qa"},
"is_default": false,
"created_at": "2026-06-16T14:30:00Z",
"updated_at": "2026-06-16T14:30:00Z"
}
]
}