v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-222763184.3 KB

source-connections

List Source Connections

Retrieve all source connections for your organization.

Returns a lightweight list of source connections with essential fields for display and navigation. Use the collection filter to see connections within a specific collection.

For full connection details including sync history, use the GET /{id} endpoint.

get/source-connections

Query parameters

collectionstring nullable

Filter by collection readable ID

Example:customer-support-tickets-x7k9m

Filter by collection readable ID

skipinteger

Number of connections to skip for pagination

limitinteger

Maximum number of connections to return (1-1000)

Example:100

Maximum number of connections to return (1-1000)

Response

List of source connections

idstring uuid required

Unique identifier of the source connection

namestring required

Display name of the connection

short_namestring required

Source type identifier

readable_collection_idstring required

Collection this connection belongs to

created_atstring date-time required

When the connection was created (ISO 8601)

modified_atstring date-time required

When the connection was last modified (ISO 8601)

is_authenticatedboolean required

Whether the connection has valid credentials

entity_countinteger

Total number of entities synced from this connection

federated_searchboolean

Whether this source uses federated (real-time) search instead of syncing

auth_method'direct' | 'oauth_browser' | 'oauth_token' | 'oauth_byoc' | 'auth_provider' required

Authentication methods for source connections.

Source connection status enum - represents overall connection state.

Example response

[
  {
    "auth_method": "direct",
    "created_at": "2024-03-15T09:30:00Z",
    "entity_count": 1250,
    "federated_search": false,
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "is_authenticated": true,
    "modified_at": "2024-03-15T14:22:15Z",
    "name": "GitHub Docs Repo",
    "readable_collection_id": "documentation-ab123",
    "short_name": "github",
    "status": "ACTIVE"
  }
]