Container Proxy Settings

Retrieve and update the container-wide proxy root configuration: the enable_proxy kill-switch and the default allow/deny policy applied when no more-specific rule matches. Both endpoints return an etag and file_version to support optimistic-concurrency control on updates.

Note

The PATCH endpoint requires an If-Match header containing the current etag (for example, file:v3). This prevents concurrent updates from silently overwriting each other.

---

GET /api/v1/containers/{id}/proxy/settings

Returns the current proxy root settings for a container, including the enable_proxy flag, the default policy, the internal file_version, and the etag value required for safe updates.

Parameters

Name	In	Type	Required	Description
id	path	string	Yes	Container ID

Response

200

{
  "statusCode": 200,
  "message": "Proxy settings retrieved successfully",
  "data": {
    "enable_proxy": true,
    "default": "allow",
    "file_version": 3,
    "etag": "file:v3"
  }
}

SDK

SDK

const settings = await client.api.proxyDiscovery.getContainerProxySettings({
  id: "c8f2e1a4b9d34e6f8a7c1d2e3f4a5b6c",
});

cURL

curl -X GET "https://api.hoody.com/api/v1/containers/c8f2e1a4b9d34e6f8a7c1d2e3f4a5b6c/proxy/settings" \
  -H "Authorization: Bearer <token>"

---

PATCH /api/v1/containers/{id}/proxy/settings

Updates one or both of the proxy root fields (enable_proxy, default). Provide the current etag in the If-Match header to enforce optimistic-concurrency control. At least one body field must be supplied.

Parameters

Name	In	Type	Required	Description
id	path	string	Yes	Container ID
if-match	header	string	No	file:v≤N≥ ETag precondition

Request Body

Field	Type	Required	Description
enable_proxy	boolean	No	Global kill-switch for the container proxy
default	string	No	Default policy when no rule matches. One of allow, deny

{
  "enable_proxy": true,
  "default": "deny"
}

Response

200

{
  "statusCode": 200,
  "message": "Proxy settings updated successfully",
  "data": {
    "enable_proxy": true,
    "default": "deny",
    "file_version": 4,
    "etag": "file:v4"
  }
}

SDK

SDK

const updated = await client.api.proxyDiscovery.updateContainerProxySettings({
  id: "c8f2e1a4b9d34e6f8a7c1d2e3f4a5b6c",
  "if-match": "file:v3",
  data: {
    enable_proxy: true,
    default: "deny",
  },
});

cURL

curl -X PATCH "https://api.hoody.com/api/v1/containers/c8f2e1a4b9d34e6f8a7c1d2e3f4a5b6c/proxy/settings" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -H "If-Match: file:v3" \
  -d '{
    "enable_proxy": true,
    "default": "deny"
  }'