Skip to content
API Reference
/
/
/
Modify browser profile

Modify browser profile

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
}