Skip to content
API Reference
/
/
/
Refresh profile fingerpri...

Refresh profile fingerprint

Request

Regenerate the fingerprint of a browser profile.

  • Preconditions: identify the profile by envId or uniqueId. Encrypted profiles are rejected. A running profile is not blocked, but the new fingerprint applies from the next start.
  • Effect: generates a fresh fingerprint, randomises host name and MAC address, and re-matches the browser kernel. Values supplied in the request win over the generated ones.
  • Completion: synchronous.
  • Retry: never retry automatically. Each call produces a different random fingerprint, so a blind retry after a timeout changes the profile a second time. Compare /env/detail first.
  • Open API: the operating system in the request takes precedence; when omitted, the one stored on the profile is used to pick a published kernel. No client information is read.

Documented business errors: 19039, 19104, 19105, 19106, 19107, 19108, 19111, 19142, 19193. See Error Codes for what each code means. Any operation can additionally return the common codes.

Security
OpenApiBearer
Bodyapplication/jsonrequired
envIdstring(EnvironmentId)^[1-9]\d*$

Profile ID. Provide this or uniqueId.

Example:"1800000000000001"
uniqueIdinteger, (int32)

Profile sequence number. Provide this or envId.

Example:1001
browserCoreinteger, >= 0

Kernel major version. 0 or omitted means automatic matching.

Example:124
uaVersioninteger, >= 0

UA major version. 0 or omitted refreshes according to business rules.

Example:124
browserTypeIdinteger(BrowserType)

Browser type:

  • 1 — Chrome
  • 2 — Firefox
Enum:12
Example:1
operatorSystemIdinteger(OperatingSystem)

Operating system:

  • 1 — Windows
  • 2 — macOS
  • 3 — Android
  • 4 — iOS
  • 5 — Linux
Enum:12345
Example:1
systemBitTypeinteger(SystemBitType)

System bitness. Defaults to 1:

  • 0 — 32-bit
  • 1 — 64-bit
Default:1
Enum:01
Example:1
architectureinteger(Architecture)

CPU architecture. Defaults to 0:

  • 0 — x86
  • 1 — ARM
Default:0
Enum:01
Example:0
advancedSettingobject(AdvancedSetting)

Dynamic fingerprint configuration. Keys come from the profile advanced-settings protocol; each value may be a string, number, boolean, array, or object depending on the key.

Example:
{
  "language": "en-US",
  "timezone": "America/Los_Angeles"
}
curl -i -X POST \
  https://api.morelogin.com/env/fingerprint/refresh \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "envId": "1800000000000001",
    "browserCore": 124,
    "uaVersion": 124,
    "browserTypeId": 1,
    "operatorSystemId": 1,
    "systemBitType": 1,
    "architecture": 0
  }'

Responses

Success

Bodyapplication/json
codeintegerrequired

Return result code. 0 means success; other codes indicate exceptions.

Example:0
msgstring or nullrequired

Error message. Usually null on success.

Example:null
requestIdstring

Operation request ID. This field may be present when the request passes through the API gateway.

Example:"1d4f3ea968664593860b94b35d4ebf5e"
datanull
Example:null
Response
{
  "code": 0,
  "msg": null,
  "requestId": "1d4f3ea968664593860b94b35d4ebf5e",
  "data": null
}