List Partner Shared Connections

Lists shared copies of a connection owned by a specific organization in the partner account. The `org_id` must match the organization that owns the parent connection. If it does not, the endpoint returns `404` rather than exposing information about the parent connection. This endpoint is useful in partner workflows where the parent connection is in the partner owner organization and the caller needs to audit which child organizations already have a shared copy. ## Observed rate limits You can use `rate_limit` to inspect observed rate limiting separately from Connection health. A Connection can be healthy while Polytomic has an active rate-limit marker. Shared Connections combine observations recorded for their own ID and their root Connection. Observations recorded only for another shared copy are not included. When these observed periods overlap or touch, `limited_since` reflects the start of the continuous period and `expires_at` reflects its latest expiry. An expired period separated from the active period by a gap does not extend that start. > ⚠️ Observation, not a capacity guarantee > > An active marker does not mean every endpoint or sync is blocked. No active > marker does not guarantee that the upstream service has capacity. The marker > expiry can be extended and is not a promised provider reset or exact retry time. If any required lookup is unavailable, `rate_limit` is `null`. This does not change `status` or `status_error`, and the Connection response is still returned.

Authentication

AuthorizationBearer
Bearer partner API key

Path parameters

org_idstringRequiredformat: "uuid"
Unique identifier of the organization that owns the parent connection.
connection_idstringRequiredformat: "uuid"
Unique identifier of the parent connection whose shared copies should be listed.

Headers

X-Polytomic-VersionstringOptional

Response

OK
datalist of objects or nullOptional

Errors

403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
500
Internal Server Error