Execute Connection Proxy

Beta
Proxies an HTTP request to a connection's underlying API using the connection's stored credentials, subject to per-connection rate limits and size caps. This endpoint is intended for controlled passthrough use, not as a general replacement for Polytomic's modeled endpoints. The request is executed with the connection's stored credentials and inherited base URL, headers, and query parameters. Before building requests dynamically, call [`GET /api/connections/{id}/proxy/info`](../../../../api-reference/connections/get-proxy-info) to inspect the inherited base URL, blocked headers, accepted body types, and size and rate limits. ## Important behavior - `request.path` must be relative and start with `/`. - Use either `request.query` or `request.rawQuery`, not both. - Caller-supplied headers are merged with inherited headers, but inherited auth headers cannot be overridden. - The proxy strips a fixed set of request and response headers for safety. - Response bodies larger than the configured maximum are truncated, and `truncated` is set to `true`. The response includes `proxyCallId`, which you can use to correlate the call with audit logs.

Authentication

AuthorizationBearer
Bearer user API key
OR
AuthorizationBasic

Basic organization-scoped API key

Path parameters

idstringRequiredformat: "uuid"
Unique identifier of the connection to proxy the request through.

Headers

X-Polytomic-VersionstringRequired

Request

This endpoint expects an object.
requestobjectRequired

Response

OK
dataobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error
502
Bad Gateway Error
504
Gateway Timeout Error