Create Profile | BCTRL Docs

curl -X POST https://api.bctrl.ai/v1/browser-profiles \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "handle": "user123-profile"
}'

{
  "createdAt": "2024-06-01T10:15:30Z",
  "currentDriver": "chrome-112.0.5615.49",
  "displayName": "User 123 Chrome Profile",
  "extensionIds": [
    "a1b2c3d4e5f6g7h8i9j0"
  ],
  "fingerprintConfig": {
    "browser": "chrome",
    "locale": "en-US"
  },
  "handle": "user123-profile",
  "hasProxy": true,
  "humanize": true,
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "kind": "browser",
  "lastUsedAt": "2024-06-10T08:45:00Z",
  "mobility": "sticky",
  "runtime": {
    "currentDriver": "chrome-112.0.5615.49",
    "id": "7e57d004-2b97-0e7a-b45f-5387367791cd",
    "region": "us-west-2",
    "spaceId": "1c6f8e2a-3d4b-4f5a-9c7e-123456789abc",
    "status": "active",
    "defaultContextId": "ctx-7890",
    "defaultPageId": "page-4567"
  },
  "status": "running",
  "stealth": "medium",
  "updatedAt": "2024-06-10T09:00:00Z"
}

Create a persistent browser profile for browser runtimes. Use profiles when automation needs durable cookies, identity, settings, or extensions.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Request

This endpoint expects an object.

handlestringRequired1-64 characters

configobjectOptional

displayNamestringOptional1-200 characters

extensionIdslist of stringsOptional

Response

Default Response

createdAtstring

currentDriverstring or null

displayNamestring or null1-200 characters

extensionIdslist of strings

fingerprintConfigobject or null

handlestring1-64 characters

hasProxyboolean

humanizeboolean

idstringformat: "uuid"

kind"browser"

lastUsedAtstring or null

mobilityenum

Allowed values:

runtimeobject or null

statusenum

Allowed values:

stealthenum

Allowed values:

updatedAtstring or null