Skip to navigation

List Current Org Shared Connections

Lists shared copies of a connection that the caller’s organization owns.

The returned connections are the child copies, not the parent connection itself. This is useful when a partner workflow needs to confirm which downstream organizations have already received a shared copy.

Creating a new shared copy is a separate operation. Use POST /api/organizations/{org_id}/connections/{connection_id}/share for the v5 partner-scoped flow.

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 user API key
OR
AuthorizationBasic

Basic organization-scoped API key

Path parameters

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