Skip to main content
Connectors allow you to sync data from external sources into your Hexel Studio knowledge bases.

​
Supported Connectors

ConnectorStatusDescription
Amazon S3AvailableSync files from S3 buckets
Google Cloud StorageAvailableSync files from GCS
Azure BlobComing soonSync files from Azure
NotionComing soonSync Notion pages
ConfluenceComing soonSync Confluence spaces

​
Creating a Connector

​
S3 Connector

connector = client.connectors.create(
    name="my-s3-connector",
    type="s3",
    config={
        "bucket": "my-bucket",
        "prefix": "documents/",
        "region": "us-east-1"
    },
    credentials={
        "access_key_id": "...",
        "secret_access_key": "..."
    },
    knowledge_base_id=kb.id
)

​
Sync Operations

​
Manual Sync

# Trigger a sync
sync = client.connectors.sync(connector_id=connector.id)

# Check sync status
status = client.connectors.get_sync_status(sync_id=sync.id)
print(f"Status: {status.state}")  # pending, running, completed, failed

​
Scheduled Sync

# Set up automatic sync
client.connectors.update(
    connector_id=connector.id,
    schedule="0 */6 * * *"  # Every 6 hours
)

​
File Processing

Connectors automatically process supported file types:
FormatExtensionProcessing
PDF.pdfText extraction
Word.docxText extraction
Markdown.mdDirect ingestion
Text.txtDirect ingestion
HTML.htmlText extraction

​
Webhook Events

Subscribe to connector events: 
client.webhooks.create(
    url="https://your-app.com/webhook",
    events=["connector.sync.completed", "connector.sync.failed"]
)