Get Source Connection

from airweave import AirweaveSDK
client = AirweaveSDK(
    api_key="YOUR_API_KEY",
)
client.source_connections.get(
    source_connection_id="550e8400-e29b-41d4-a716-446655440000",
)

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

Retrieve details of a specific source connection.

Returns complete information about the connection including:

Configuration settings
Authentication status
Sync schedule and history
Entity statistics

Retrieve details of a specific source connection. Returns complete information about the connection including: - Configuration settings - Authentication status - Sync schedule and history - Entity statistics

Authentication

x-api-keystring

API Key authentication via header

Path parameters

source_connection_idstringRequiredformat: "uuid"

Unique identifier of the source connection (UUID)

Response

Source connection details

idstringformat: "uuid"

Unique identifier of the source connection

organization_idstringformat: "uuid"

Organization this connection belongs to

namestring

Display name of the connection

short_namestring

Source type identifier

readable_collection_idstring

Collection this connection belongs to

statusenum

Current operational status of the connection

created_atstringformat: "date-time"

When the connection was created (ISO 8601)

modified_atstringformat: "date-time"

When the connection was last modified (ISO 8601)

authobject

Authentication status and details

descriptionstring or null

Optional description of the connection's purpose

configmap from strings to any or null

Source-specific configuration values

scheduleobject or null

Sync schedule configuration

syncobject or null

Sync execution history and statistics

sync_idstring or nullformat: "uuid"

ID of the associated sync (internal use)

entitiesobject or null

Summary of synced entities by type

federated_searchboolean or nullDefaults to false

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

Authentication

Path parameters

Response

Errors