Modify browser profile

API 参考

Request

Update an existing browser profile. Only the fields present in the request are changed.

When the kernel has to be re-matched, the operating system already stored on the profile is used. No client operating system or version is read.

Security

OpenApiBearer

Bodyapplication/jsonrequired

envIdstring(EnvironmentId)^[1-9]\d*$required

Profile ID. The request also accepts the field alias id.

Example:"1800000000000001"

envNamestring, <= 100 characters

Profile name.

Example:"marketing-01-updated"

groupIdstring^\d+$

Group ID. 0 means ungrouped.

Example:"0"

groupNamestring, <= 50 characters

Group name. The group is looked up or created automatically when supplied.

Example:"Marketing"

tagIdsArray of strings

Tag IDs.

Example:

[
  "1800000000000301"
]

proxyIdstring^\d+$

Existing proxy ID. 0 means no proxy.

Example:"0"

envRemarkstring, <= 1500 characters

Profile remark.

Example:"Updated through the Open API"

uaVersioninteger, >= 0

UA major version.

Example:124

browserCoreinteger, >= 0

Kernel major version.

Example:124

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

accountInfoobject(AccountInfo)

Platform account bound to the profile.

isShowAccountinteger(ToggleFlag)

Password protection switch.

Enum:01

Example:0

afterStartupConfigobject(AfterStartupConfigInput)

Behavior applied after the browser starts.

startupParamsArray of strings

Example:

[
  "--disable-notifications"
]

cookiesstring

Cookies as a JSON text payload.

Example:"[{\"name\":\"sid\",\"value\":\"abc\"}]"

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"
}

disableAudiointeger(ToggleFlag)

Whether to block audio playback.

Enum:01

Example:0

disableVideointeger(ToggleFlag)

Whether to block video loading.

Enum:01

Example:0

disableImginteger(ToggleFlag)

Whether to block image loading.

Enum:01

Example:0

imgLimitSizeinteger, [ 0 .. 100000 ]

Maximum image size to load, in KB.

Example:1000

hostnameSourceinteger

Device name source:

0 — custom
1 — real

Enum:01

Example:0

hostnamestring

Device name. Used when hostnameSource is 0.

Example:"DESKTOP-OPENAPI"

macAddressSourceinteger

MAC address source:

0 — custom
1 — real

Enum:01

Example:0

macAddressstring

MAC address. Used when macAddressSource is 0.

Example:"00:16:3E:12:34:56"

POST

/env/update

curl -i -X POST \
  https://api.morelogin.com/env/update \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "envId": "1800000000000001",
    "envName": "marketing-01-updated",
    "envRemark": "Updated through the Open API",
    "uaVersion": 124,
    "browserCore": 124,
    "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
}