Skip to main content
PUT
Update sandbox network

Authorizations

X-API-Key
string
header
required

Path Parameters

sandboxID
string
required

Body

application/json

Network configuration update for a running sandbox. Replaces the current egress rules with the provided configuration. Omitting a field clears it.

allowOut
string[]

Destinations to allow: IPv4 addresses, CIDR blocks (e.g. "203.0.113.0/24") and exact host names (e.g. "api.example.com"). Allowed entries take precedence over denied entries. Anona: a host name needs public egress off (allow_internet_access: false, or 0.0.0.0/0 in denyOut). Wildcard names such as *.example.com are refused with 400 (wildcard host names are not supported yet; name exact hosts), and so are names that do not resolve yet and destinations in private or reserved ranges, including names that resolve into them. The sandbox's DNS resolvers, 1.1.1.1 and 1.0.0.1, are always allowed.

denyOut
string[]

List of denied CIDR blocks or IP addresses for egress traffic. Domain names are not supported for deny rules.

dnsServers
string[]

Anona: sandboxes resolve names through 1.1.1.1 and 1.0.0.1, which are always allowed, and this field does not change that or the sandbox's /etc/resolv.conf. Any other IPv4 address listed here is added to the allowed destinations when allowOut has a host name and public egress is off; otherwise it is accepted and has no effect. The free plan accepts only 1.1.1.1 and 1.0.0.1, and an address in a reserved range is refused with 400.

Maximum array length: 10
egressProxy
object | null

Not supported on Anona. Any value other than null is refused with 400 (SOCKS5 egress proxies are not supported), on create and on update.

rules
object

Per-host header rules for the sandbox's outbound HTTPS requests. Anona: each key is one exact host name, normalized to lowercase. A wildcard key such as *.example.com is refused with 400 (a wildcard is not allowed here; name the exact host), and so is an IP address. Rules apply to HTTPS only. A rule does not allow the host on its own: with public egress off, list the host in allowOut too, or the rule is dropped with a warning. The host must be on the secret's allowed hosts (403 otherwise), and a rule that needs a new credential binding needs a caller who may create one (403 otherwise); see Networking.

allow_internet_access
boolean

Allow sandbox to access the internet. When set to false, it behaves the same as specifying denyOut to 0.0.0.0/0 in the network config.

Response

Successfully updated the sandbox network configuration