DataSource

Create a new data source

Changed on May 21, 2026

Create a new data source configuration for a knowledge base

post/datasource

Request

Base URL
/api/v1 (relative, and the document was published on a file host, not at the API’s origin)
URL
/api/v1/datasource
Auth
none declared

Request body

configobject

Encrypted configuration (API credentials, tokens, etc.) Stored as JSON with AES-256-GCM encryption

conflict_strategystring

Conflict resolution strategy: overwrite or skip

created_atstring

Creation timestamp

error_messagestring

Error message if status is "error"

idstring

Unique identifier

knowledge_base_idstring

Target knowledge base ID

last_sync_atstring

Last successful sync timestamp

last_sync_cursorobject

Cursor or state for incremental sync (connector-specific)

last_sync_resultobject

Summary of last sync result

namestring

User-friendly name

statusstring

Current status: active, paused, error

sync_deletionsboolean

Whether to sync deletions from source

sync_log_retention_daysinteger

Number of days to keep sync logs (default: 30)

sync_modestring

Sync mode: "incremental" (recommended) or "full"

sync_schedulestring

Cron expression for scheduled syncs (e.g., "0 */6 * * *" = every 6 hours)

tenant_idinteger

Workspace ID for multi-workspace isolation

total_items_syncedinteger

Total items synced (not stored in DB, calculated on query)

typestring

Connector type (feishu, notion, confluence, etc.)

updated_atstring

Last update timestamp

Response

Created