API Reference
/- Browser
- Local API
- Modify browser profile
Batch set browser profile tags
Quick create browser profile
Advanced create browser profile
Delete browser profile
Get a list of browser profiles
Get browser profile details
Get browser security lock status
Batch modify profiles group
Batch modify profiles proxy
Batch modify profile remark
Modify browser profile
Update an existing browser profile. Only the fields present in the request are changed.
- Preconditions: the profile must exist in the team. End-to-end encrypted profiles cannot be updated. The operating system and browser type cannot be changed. A running profile can be updated.
- Effect: writes the profile row, its expanded settings and cookies, and merges the advanced fingerprint settings (existing values are kept unless overwritten).
- Completion: synchronous.
- Retry: safe to repeat with the same body. Note there is no optimistic locking: concurrent updates to one profile are last-write-wins, and the fingerprint merge reads before it writes, so concurrent callers can lose changes.
Documented business errors: 19001, 19039, 19104, 19105, 19106, 19107, 19108, 19142, 19159, 19160, 19175, 19193. See Error Codes for what each code means. Any operation can additionally return the common codes.
Kernel version; default:0 (auto-match). Fetch available versions via /api/env/advanced/ua/versions.
Group name (max 50 characters). If provided, the system first checks groupId: if a valid group is found, it is used; otherwise, it searches by groupName. If a group with that name exists, it is referenced; if not, a new group is created. Each team is limited to 1,000 groups.
- Local APIhttp://127.0.0.1:40000/api/env/update
curl -i -X POST \
http://127.0.0.1:40000/api/env/update \
-H 'Content-Type: application/json' \
-d '{
"browserTypeId": 1,
"operatorSystemId": 1,
"isEncrypt": 1,
"envId": "1661515884160372",
"hostnameSource": 0,
"hostname": "DESKTOP-OPENAPI",
"macAddressSource": 0,
"macAddress": "00:16:3E:12:34:56"
}'Response
{ "code": 0, "msg": null, "data": null, "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d" }