Browser Profiles

Browser profiles are persistent browser identities — saved cookies, local storage, and browser fingerprints that survive across runtime restarts. Use them when you need a runtime to “remember” logged-in sessions.

Access via bctrl.browserProfiles.

list()

List all browser profiles in your organization.

1
const profiles = await bctrl.browserProfiles.list();

Returns BrowserProfile[]

create(request)

Create a new browser profile.

1
const profile = await bctrl.browserProfiles.create({
2
  name: "sales-bot",
3
  description: "Salesforce automation profile",
4
});

Returns BrowserProfileDetail

get(id)

Get a specific profile by ID.

1
const profile = await bctrl.browserProfiles.get("prof_abc123");

Returns BrowserProfileDetail

update(id, request)

Update a profile’s metadata.

1
await bctrl.browserProfiles.update("prof_abc123", {
2
  description: "Updated description",
3
});

Returns BrowserProfileDetail

delete(id)

Delete a profile and all its saved state.

1
await bctrl.browserProfiles.delete("prof_abc123");

Usage with runtimes

Launch a runtime with a profile to use its saved state:

1
const runtime = await workspace.runtimes.browser("crm").playwright({
2
  mode: "profile",
3
  profileId: "sales-bot",
4
});
5
6
// The browser starts with the profile's saved cookies and storage
7
await runtime.page.goto("https://crm.example.com");
8
// Already logged in if the session was saved

When the runtime stops, the profile state is saved automatically.