DataSource

修改数据源同步配置

Changed on
patch/datasource/{id}/sync-settings

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/{id}/sync-settings
  • Auth
    • API key in header Authorization
    • or API key in header X-API-Key

Path parameters

idstring required

数据源 ID

Request body

conflict_strategy'overwrite' | 'skip'

Overwrite existing content or skip conflicts.

resource_idsstring[]

Replaces the complete selection. Get IDs from data_source.list_resources; never infer them from names.

sync_deletionsboolean

Whether future syncs delete documents that were removed upstream.

sync_mode'incremental' | 'full'

Incremental sync or a full scan.

sync_schedulestring

Six-field cron including seconds, optionally prefixed with CRON_TZ=Area/City. Empty disables scheduled sync.

Response

OK

conflict_strategystring
created_atstring
credentialsobject

Single logical credential field — DataSource credentials are a per-connector atomic map, so "configured?" applies to the whole set.

error_messagestring
idstring
knowledge_base_idstring
last_sync_atstring
last_sync_cursorobject
last_sync_resultobject
namestring
statusstring
sync_deletionsboolean
sync_log_retention_daysinteger
sync_modestring
sync_schedulestring
tenant_idinteger
total_items_syncedinteger
typestring
updated_atstring

Changes