Execute Connection Proxy
Authentication
Basic organization-scoped API key
Basic organization-scoped API key
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
to inspect the inherited base URL, blocked headers, accepted body types, and
size and rate limits.
request.path must be relative and start with /.request.query or request.rawQuery, not both.truncated is set to true.To run a GET request asynchronously, set async to true. The initial
response returns status: 202, jobId, jobStatus, and jobUrl. Poll
GET /api/jobs/{type}/{id} with
type=connectionproxy and the returned jobId until the job is complete. The
completed job result includes the upstream status, sanitized headers,
contentType, contentLength, latencyMs, and a short-lived
bodyDownloadUrl for the upstream response body.
The response includes proxyCallId, which you can use to correlate the call
with audit logs.