Fingerprints

Generate a new fingerprint (host OS)

get

Returns a fully uniquified fingerprint for the host operating system, without persisting it. Equivalent to /fingerprint/new/{platform} with the launcher host's platform.

Authorizations

bearerAuth

AuthorizationstringRequired

Permanent JWT from Settings → Automation API.

Responses

200

A uniquified, unsaved fingerprint.

application/json

401

Missing or invalid Bearer token.

404

The fingerprint library is empty.

application/json

get

/fingerprint/new

HTTPcURLJavaScriptPython

GET /fingerprint/new HTTP/1.1
Host: 127.0.0.1:40325
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "fingerprint": {
    "name": "text",
    "notes": "text",
    "seed": 1,
    "navigator": {
      "user_agent": "text",
      "platform": "Win32",
      "hardware_concurrency": 12,
      "device_memory": 16,
      "language": "text",
      "do_not_track": true,
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "screen": {
      "width": 1,
      "height": 1,
      "avail_width": 1,
      "avail_height": 1,
      "color_depth": 24,
      "device_pixel_ratio": 2,
      "color_gamut": "",
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "client_hints": {
      "platform": "text",
      "platform_version": "text",
      "architecture": "x86",
      "bitness": "64",
      "mobile": true,
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "webgl": {
      "unmasked_vendor": "text",
      "unmasked_renderer": "text",
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "webgpu": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "webrtc": "auto",
    "noise": {
      "canvas": {
        "enabled": true,
        "seed": 1
      },
      "webgl": {
        "intensity": 1,
        "enabled": true,
        "seed": 1
      },
      "audio": {
        "intensity": 1,
        "enabled": true,
        "seed": 1
      },
      "client_rects": {
        "max_offset": 1,
        "enabled": true,
        "seed": 1
      },
      "sensors": {
        "enabled": true,
        "seed": 1
      },
      "fonts": {
        "enabled": true,
        "seed": 1
      }
    },
    "network": {
      "blocked_ports": [
        1
      ]
    },
    "timezone": "text",
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Generate a new fingerprint for a platform

get

Picks a random library fingerprint matching platform, then uniquifies it: a fresh Sec-CH-UA platform_version, host-aware hardware_concurrency/device_memory (never claims more than the real machine), and a screen clamped to the real display. Returned unsaved — feed it to a create endpoint as fingerprint.

Authorizations

bearerAuth

AuthorizationstringRequired

Permanent JWT from Settings → Automation API.

Path parameters

platformstring · enumRequired

Case-insensitive; win/osx/darwin aliases accepted.

Possible values:

Responses

200

A uniquified, unsaved fingerprint.

application/json

401

Missing or invalid Bearer token.

404

No matching fingerprint and the library is empty.

application/json

get

/fingerprint/new/{platform}

HTTPcURLJavaScriptPython

GET /fingerprint/new/{platform} HTTP/1.1
Host: 127.0.0.1:40325
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "fingerprint": {
    "name": "text",
    "notes": "text",
    "seed": 1,
    "navigator": {
      "user_agent": "text",
      "platform": "Win32",
      "hardware_concurrency": 12,
      "device_memory": 16,
      "language": "text",
      "do_not_track": true,
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "screen": {
      "width": 1,
      "height": 1,
      "avail_width": 1,
      "avail_height": 1,
      "color_depth": 24,
      "device_pixel_ratio": 2,
      "color_gamut": "",
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "client_hints": {
      "platform": "text",
      "platform_version": "text",
      "architecture": "x86",
      "bitness": "64",
      "mobile": true,
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "webgl": {
      "unmasked_vendor": "text",
      "unmasked_renderer": "text",
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "webgpu": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "webrtc": "auto",
    "noise": {
      "canvas": {
        "enabled": true,
        "seed": 1
      },
      "webgl": {
        "intensity": 1,
        "enabled": true,
        "seed": 1
      },
      "audio": {
        "intensity": 1,
        "enabled": true,
        "seed": 1
      },
      "client_rects": {
        "max_offset": 1,
        "enabled": true,
        "seed": 1
      },
      "sensors": {
        "enabled": true,
        "seed": 1
      },
      "fonts": {
        "enabled": true,
        "seed": 1
      }
    },
    "network": {
      "blocked_ports": [
        1
      ]
    },
    "timezone": "text",
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

List library fingerprints

get

The on-disk fingerprint library (GPU presets) the launcher ships/imports.

Authorizations

bearerAuth

AuthorizationstringRequired

Permanent JWT from Settings → Automation API.

Responses

200

Library entries.

application/json

idstringOptional

labelstringOptional

platformstring · enumOptionalPossible values:

chromestringOptional

Chrome version string.

gpustringOptional

builtinbooleanOptional

Part of the bundled starter set.

401

Missing or invalid Bearer token.

get

/fingerprints

HTTPcURLJavaScriptPython

GET /fingerprints HTTP/1.1
Host: 127.0.0.1:40325
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "text",
    "label": "text",
    "platform": "Windows",
    "chrome": "text",
    "gpu": "text",
    "builtin": true
  }
]