- API Reference
- Box API
- Proxy settings
Change an existing proxy group
Finds the group by primary_port and merges the posted fields into it, then reloads all proxies. Needs the proxy-group license feature and a non-empty position_list.
/edit_proxy_group_configRequest body application/json · required
Port of the group proxy. Identifies the group.
Slots (positions) that serve the group.
0 HTTP over IPv4, 1 SOCKS5 over IPv4, 2 HTTP over IPv6, 3 SOCKS5 over IPv6.
0, 1, 2, 3Proxy username of the group (empty for none).
Proxy password of the group (empty for none).
Client IPs allowed without a password, comma separated.
When true, each new connection picks a random slot instead of the next one.
Authentication
Needs a trusted caller (loopback, LAN unless "force auth for local" is on, whitelisted IP, allowed Tailscale) or valid dashboard Basic credentials, which are checked only when dashboard authentication is enabled.
Responses
The posted data echoed back, or a refusal.
One proxy group: a single shared port (primary_port) that spreads clients over the listed slots.
Port of the group proxy. Identifies the group.
Slots (positions) that serve the group.
0 HTTP over IPv4, 1 SOCKS5 over IPv4, 2 HTTP over IPv6, 3 SOCKS5 over IPv6.
0, 1, 2, 3Proxy username of the group (empty for none).
Proxy password of the group (empty for none).
Client IPs allowed without a password, comma separated.
When true, each new connection picks a random slot instead of the next one.
The caller is not trusted (not loopback, LAN, whitelisted or allowed Tailscale) and sent no valid Basic credentials. The body depends on whether "Basic auth for all API" is on. Routes that also use the panel login can answer a plain-text 401 "Unauthorized Access" instead.
Unhandled error, for example a non-integer position or a missing required parameter.
Error name, e.g. internal_server_error or bad_request.
Errors returned in msg
| msg | Meaning | What to do |
|---|---|---|
This function is available on higher plan license only. Please contact Administrator! | The license has no proxy-group feature. | Upgrade the license. |
Proxy group must have at least one postion | position_list is missing or empty (the typo is in the box message). | Send at least one slot. |
Proxy group not found | No group uses this primary_port. | Read /proxy_group_config for the existing ports. |