List Current Org Shared Connections

curl https://app.polytomic.com/api/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 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.

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`](./create-shared-connection) for the v5 partner-scoped flow.

Authentication

AuthorizationBearer

Bearer user API key

AuthorizationBasic

Basic organization-scoped API key

Path parameters

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