---
title: "Set proxy"
method: POST
path: "/boxes/{boxId}/proxy"
tags: ["Box"]
---

# Set proxy

`POST /boxes/{boxId}/proxy`

Configures the HTTP proxy settings for a specific box. Use this endpoint when you need the box's outbound network traffic to pass through a proxy server.

## Path parameters

- `boxId` string, required

## Request body

- BoxHttpProxy — Box Http Proxy
  - `auth` BoxProxyAuth — Box Proxy Auth
    - `username` string, required — Username for the proxy
    - `password` string, required — Password for the proxy
  - `excludes` string[] — List of IP addresses and domains that should bypass the proxy. These addresses will be accessed directly without going through the proxy server. Default is ['127.0.0.1', 'localhost']
  - `host` string, required — The host address of the proxy server
  - `port` number, required — The port number of the proxy server
  - `pacUrl` string — PAC (Proxy Auto-Configuration) URL.

## Response `200`

Proxy set

- BoxHttpProxy — Box Http Proxy
  - `auth` BoxProxyAuth — Box Proxy Auth
    - `username` string, required — Username for the proxy
    - `password` string, required — Password for the proxy
  - `excludes` string[] — List of IP addresses and domains that should bypass the proxy. These addresses will be accessed directly without going through the proxy server. Default is ['127.0.0.1', 'localhost']
  - `host` string, required — The host address of the proxy server
  - `port` number, required — The port number of the proxy server
  - `pacUrl` string — PAC (Proxy Auto-Configuration) URL.

---

[API](https://skmtc.net/babelcloud/apis/gbox-open-api.md) · [All operations](https://skmtc.net/babelcloud/apis/gbox-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/babelcloud/gbox-open-api/versions/d655577fa915/schema)