---
title: "Update Connection Proxy Settings"
method: PUT
path: "/api/connections/{id}/proxy/settings"
tags: ["Connections"]
---

# Update Connection Proxy Settings

`PUT /api/connections/{id}/proxy/settings`

Enables or disables use of a connection through the Connection Proxy API.

The setting is stored on the parent connection. To update proxy access for a
shared connection, the caller must have edit permission for the parent
connection.

Enabling proxy access requires a backend that supports the Connection Proxy API.
If the connection backend is unsupported, the request returns `400 Bad Request`.
Disabling proxy access is allowed for any connection the caller can edit.

Setting `enabled` to `false` prevents proxy calls for the connection.

## Path parameters

- `id` string, uuid, required — Unique identifier of the connection whose proxy settings should be updated.

## Headers

- `X-Polytomic-Version` string

## Request body

- UpdateConnectionProxySettingsRequest
  - `enabled` boolean, required — Whether the connection can be used through the Connection Proxy API.

## Response `200`

OK

- ConnectionProxySettingsEnvelope
  - `data` ConnectionProxySettingsResponse
    - `backendType` string — Connection backend identifier (e.g. hubspot, salesforce).
    - `connectionId` string, uuid — Unique identifier of the requested connection.
    - `enabled` boolean — True when the connection can currently be used through the Connection Proxy API.
    - `parentConnectionId` string, uuid — Unique identifier of the parent connection where proxy settings are stored. Omitted for non-shared connections.
    - `supported` boolean — True when the connection backend supports the Connection Proxy API.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

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