create-environment
Create a new browser profile environment in DICloak with a specified name, browser, and group ID for isolated browsing, profile management, or automation.
Instructions
Create a new environment
IMPORTANT: Server requires a complete request body. Full template (use as-is, replace required fields like name, browser, group_id): { "extensions_type": "ALLOW", "name": "", "browser": "CHROME", "group_id": "", "browser_version_id": "120", "ua_os": "WINDOWS", "os": { "windows": [ "windows-all" ], "mac": [], "android": [], "ios": [], "linux": [] }, "ua_type": "["all"]", "ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.6134.0 Safari/537.36", "proxy_way": "CUSTOM", "proxy_type": "NON_USE", "proxy_ip_type": "IPAPI", "proxy_ip_addr_type": "IPV4", "account_list": [], "urls": [], "fixed_urls": [], "restore_url_type": "GLOBAL", "config": "{"acceptLangType":"ip","acceptLangValue":["en-US","en"],"langType":"acceptLang","langValue":"local","timezoneType":"ip","timezoneValue":"local","geoType":"ask","geoSubType":"ip","geoValue":{},"fontType":"custom","fontValue":["default"],"webrtcType":"disable","webrtcValue":"","canvasType":"noise","canvasValue":78307,"ratioType":"truth","ratioValue":"","ratioWidth":"","webGLImageType":"noise","webGLImageValue":12684,"mediadeviceType":"noise","mediadeviceValue":13189,"webGLMetadataType":"custom","webglManufacturer":"Google Inc. (NVIDIA)","webglRender":"ANGLE (NVIDIA, NVIDIA GeForce GTX 1050 Direct3D11 vs_5_0 ps_5_0, D3D11-31.0.15.3161)","webGPUType":"inWebGL","webGPUTypeValue":82291,"audioContextType":"noise","audioContextValue":51461,"clientRectsType":"noise","clientRectsValue":75611,"speechVoicesType":"noise","speechVoicesValue":49546,"hardwareConcurrencyValue":"10","deviceMemoryValue":"2","trackType":"0","batteryType":"noise","batteryValue":67456,"portType":"1","portValue":"","accelerateType":"0","startParams":"","deviceNameType":"truth","deviceNameValue":"","macType":"truth","macValue":"","macTruthValue":"6c:1f:f7:0f:65:58"}", "data_config_option": [ 1 ], "browser_config_option": [ 1 ], "data_type": "global", "browser_type": "global", "env_mutil_open_type": "GLOBAL", "spoofing_video_type": "DISABLE", "local_data_config": "{"type":0,"browserType":"global","dataType":null}", "proxy_soft_enable": true, "proxy_soft": "NONE", "proxy_soft_info": { "ip": "", "country": "", "country_code": "", "region": "", "region_code": "", "city": "" }, "proxy_api_info": { "ip_method": "EVERY_TIME", "url": "", "ip": "", "port": "" }, "bookmark_config_val": { "bookmark_type": "global", "status": false, "file_content": [], "cover_rule": 1, "file_name": "", "type": 1 }, "access_limit_config_val": { "access_limit_type": "global", "status": false, "type": 1, "quick_selection_option": [], "quick_selection_type": 0, "url_list": "" }, "env_tag_ids": [], "extensions_group_id": "", "data_config": "{"type":0,"dataType":"global"}", "browser_config": "{"type":0,"browserType":"global"}", "bookmark_config": "{"bookmarkType":"global","status":false,"fileContent":[],"coverRule":1,"fileName":"","type":1}", "access_limit_config": "{"accessLimitType":"global","status":false,"type":1,"quickSelectionOption":[],"quickSelectionType":0,"urlList":""}" }
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"browser": "<browser>",
"group_id": "<group_id>"
},
"name": "create-environment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| os | No | Subset configuration for multi-platform support. | |
| ua | No | User-Agent string. If omitted, a random UA is used. Random UAs follow formats like Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.6134.0 Safari/537.36. | |
| name | Yes | Environment name (must be provided by the user, or use an auto-generated placeholder). | |
| urls | No | Startup URL list (default: empty). | |
| ua_os | No | UA operating system used for UA selection. | WINDOWS |
| config | No | Fingerprint configuration (JSON string). If using the default template, keep this field as the default JSON string. For numeric values (e.g. canvasValue) generate a reasonable 5-digit integer if randomized. Other types (truth or noise) can keep the default values. | {} |
| browser | Yes | Browser type (e.g., CHROME). | CHROME |
| ua_type | No | UA selection type. | ["all"] |
| group_id | Yes | Group ID (required). If unknown, call GET /v1/env/group and use the id of the group with is_default = true. | |
| data_type | No | Data type field. | global |
| group_ids | No | List of group IDs (for backward compatibility). | |
| proxy_way | No | Proxy usage method. | CUSTOM |
| fixed_urls | No | Fixed URL list (default: empty). | |
| proxy_soft | No | Proxy provider type. | NONE |
| proxy_type | No | Proxy type. | NON_USE |
| data_config | No | Data configuration JSON string | {"type":0,"dataType":"global"} |
| env_tag_ids | No | List of environment tag IDs | |
| account_list | No | Account list (default: empty array). | |
| browser_type | No | Browser configuration type. | global |
| proxy_ip_type | No | Proxy lookup/detection source. | IPAPI |
| browser_config | No | Browser configuration JSON string | {"type":0,"browserType":"global"} |
| proxy_api_info | No | API for fetching proxy information. | |
| bookmark_config | No | Bookmark configuration JSON string | {"bookmarkType":"global","status":false,"fileContent":[],"coverRule":1,"fileName":"","type":1} |
| extensions_type | No | Extension loading policy. | ALLOW |
| proxy_soft_info | No | Proxy provider information (default: empty strings/values). | |
| restore_url_type | No | Startup page restore type. | GLOBAL |
| local_data_config | No | Compatibility field, usually a JSON string. | DISABLE |
| proxy_soft_enable | No | Whether the proxy provider reads configured accounts. | |
| browser_version_id | No | Browser version ID. | 120 |
| data_config_option | No | Data configuration options, usually an array of integers. | |
| proxy_ip_addr_type | No | Proxy IP address type. | IPV4 |
| access_limit_config | No | Access limit configuration JSON string | {"accessLimitType":"global","status":false,"type":1,"quickSelectionOption":[],"quickSelectionType":0,"urlList":""} |
| bookmark_config_val | No | Bookmark settings | |
| env_mutil_open_type | No | Multi-open type field. | GLOBAL |
| extensions_group_id | No | Extensions group ID | |
| spoofing_video_type | No | Video stream spoofing type. | DISABLE |
| browser_config_option | No | Browser configuration options, usually an array of integers. | |
| access_limit_config_val | No |