List Partner Shared Connections

curl https://app.polytomic.com/api/organizations/248df4b7-aa70-47b8-a036-33ac447e668d/connections/248df4b7-aa70-47b8-a036-33ac447e668d/shared \
     -H "X-Polytomic-Version: X-Polytomic-Version" \
     -H "Authorization: Bearer <token>"

{
  "data": [
    {
      "api_calls_last_24_hours": 2021,
      "configuration": {
        "database": "example",
        "hostname": "postgres.example.com",
        "password": "********",
        "port": 5432,
        "username": "user"
      },
      "created_at": "2024-01-15T09:30:00Z",
      "created_by": {
        "id": "12345678-1234-1234-1234-123456789012",
        "name": "John Doe",
        "type": "user"
      },
      "id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "name": "My Postgres Connection",
      "organization_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "parent_connection_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
      "policies": [
        "248df4b7-aa70-47b8-a036-33ac447e668d"
      ],
      "saved": true,
      "status": "healthy",
      "status_error": "error message",
      "type": {
        "id": "postgresql",
        "logo_url": "https://connect-assets.polytomic.com/logos/postgresql.svg",
        "name": "PostgreSQL",
        "operations": [
          "bulksyncsource"
        ]
      },
      "updated_at": "2024-01-15T09:30:00Z",
      "updated_by": {
        "id": "12345678-1234-1234-1234-123456789012",
        "name": "John Doe",
        "type": "user"
      }
    }
  ]
}

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.

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.

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.

Response

datalist of objects or null

Errors

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error

Authentication

Path parameters

Headers

Response

Errors