Connections

Get Connection Proxy Info

Changed on Oct 22, 2026

Returns the proxy contract for a connection.

Use this endpoint before calling POST /api/connections/{id}/proxy when you need to build requests programmatically. The response shows:

the inherited base URL that all proxied requests are sent to
locked headers and query parameters that are attached automatically
blocked request and response headers
allowed HTTP methods and body shapes
timeout, rate-limit, and payload-size limits

Some connections reach more than one upstream API, each with its own base URL and quota. For these, the response includes apis: one entry per API with its name, description, whether it is the default, and its own inheritedBase. The top-level inheritedBase describes the default API. Connections with a single API omit apis.

Sensitive inherited header and query values are redacted in the response. The contract is still useful for discovering which keys are fixed by the connection, even though their raw values are not exposed.

get/api/connections/{id}/proxy/info

Request

Base URL
https://app.polytomic.com
Auth
- HTTP bearer
- or HTTP basic

Path parameters

idstring uuid required

Unique identifier of the connection whose proxy contract should be returned

Example:248df4b7-aa70-47b8-a036-33ac447e668d

Headers

X-Polytomic-Versionstring

Response

Example response

{
  "data": {
    "apis": [
      {
        "name": "reports"
      }
    ],
    "connectionId": "248df4b7-aa70-47b8-a036-33ac447e668d"
  }
}

Changes

Oct 22, 2026d80b0fdea14e Revision changes
- breaking
  the response's property type changed from object to no type for status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- info
  added to the response property allOf list for the response status
Oct 21, 202661c2b96f65ba Revision changes
- breaking
  the /// response's property type changed from object to no type for status
- breaking
  the / response's property type changed from object to no type for status
- breaking
  the / response's property type changed from object to no type for status
- breaking
  the / response's property type changed from object to no type for status
- breaking
  the / response's property type changed from object to no type for status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- warning
  removed the optional property // from the response with the status
- info
  added to the / response property allOf list for the response status
- info
  added to the /// response property allOf list for the response status
- info
  added to the / response property allOf list for the response status
- info
  added to the / response property allOf list for the response status
- info
  added to the / response property allOf list for the response status

Operation history (3 revisions)