v50

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

source-connections

Get Source Connection

Retrieve details of a specific source connection.

Returns complete information about the connection including:

Configuration settings
Authentication status
Sync schedule and history
Entity statistics

get/source-connections/{source_connection_id}

Path parameters

source_connection_idstring uuid required

Unique identifier of the source connection (UUID)

Example:550e8400-e29b-41d4-a716-446655440000

Unique identifier of the source connection (UUID)

Response

Source connection details

idstring uuid required

Unique identifier of the source connection

organization_idstring uuid required

Organization this connection belongs to

namestring required

Display name of the connection

descriptionstring nullable

Optional description of the connection's purpose

short_namestring required

Source type identifier

readable_collection_idstring required

Collection this connection belongs to

Source connection status enum - represents overall connection state.

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)

configobject nullable

Source-specific configuration values

sync_idstring uuid nullable

ID of the associated sync (internal use)

federated_searchboolean

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

Example response

{
  "auth": {
    "authenticated": true,
    "authenticated_at": "2024-03-15T09:30:00Z",
    "method": "direct"
  },
  "config": {
    "branch": "main",
    "repo_name": "company/docs"
  },
  "created_at": "2024-03-15T09:30:00Z",
  "description": "Main documentation repository",
  "entities": {
    "by_type": {
      "file": {
        "count": 1250
      }
    },
    "total_entities": 1250
  },
  "federated_search": false,
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "modified_at": "2024-03-15T14:22:15Z",
  "name": "GitHub Docs Repo",
  "readable_collection_id": "documentation-ab123",
  "schedule": {
    "cron": "0 */6 * * *",
    "next_run": "2024-03-15T18:00:00Z"
  },
  "short_name": "github",
  "status": "ACTIVE",
  "sync": {
    "failed_runs": 1,
    "last_job": {
      "completed_at": "2024-03-15T12:05:32Z",
      "duration_seconds": 332,
      "entities_inserted": 45,
      "entities_updated": 12,
      "id": "770e8400-e29b-41d4-a716-446655440002",
      "started_at": "2024-03-15T12:00:00Z",
      "status": "COMPLETED"
    },
    "successful_runs": 14,
    "total_runs": 15
  }
}