Update Profile | BCTRL Docs

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

{
  "createdAt": "2024-06-01T10:15:30Z",
  "currentDriver": "chrome-112.0",
  "displayName": "Work Profile",
  "extensionIds": [
    "ext-12345",
    "ext-67890"
  ],
  "fingerprintConfig": {
    "browser": "chrome",
    "locale": "en-US"
  },
  "handle": "work-profile-01",
  "hasProxy": true,
  "humanize": true,
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "kind": "browser",
  "lastUsedAt": "2024-06-10T08:00:00Z",
  "mobility": "sticky",
  "runtime": {
    "currentDriver": "chrome-112.0",
    "id": "1c2d3e4f-5678-90ab-cdef-1234567890ab",
    "region": "us-west-2",
    "spaceId": "9f8e7d6c-5b4a-3210-fedc-ba9876543210",
    "status": "active",
    "defaultContextId": "ctx-7890",
    "defaultPageId": "page-4567"
  },
  "status": "running",
  "stealth": "medium",
  "updatedAt": "2024-06-15T12:00:00Z"
}

Update a browser profile display name, browser configuration, or attached extensions. Future browser runtimes that use the profile will use the updated settings.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Path parameters

handlestringRequired

Request

This endpoint expects an object.

configobjectOptional

displayNamestring or nullOptional1-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