v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-304917042.1 MB
knowledge-base-connectors

Update Source Schedule

Enable/disable + configure a connector source's automatic (cron) re-sync.

Enabling requires sync_interval_seconds (schema-enforced) and is floored server-side at kb_scheduled_sync_min_interval_seconds; the first run is seeded with a randomized initial delay so a batch of newly-enabled sources doesn't stampede the first sweep. Disabling clears the interval + next run.

patch/v1/knowledge-base/knowledge-bases/{kb_id}/sources/{source_id}/schedule

Path parameters

kb_idstring uuid required
source_idstring uuid required

Request body

auto_sync_enabledboolean required
sync_interval_secondsinteger nullable

Response

Successful Response

idstring uuid required
knowledge_base_idstring uuid required
providerstring
integration_connection_idstring uuid nullable
configobject nullable
statusstring required
last_sync_job_idstring uuid nullable
integration_keystring nullable
connection_nicknamestring nullable
connection_metadataobject
auto_sync_enabledboolean
sync_interval_secondsinteger nullable
next_sync_atstring date-time nullable
last_auto_sync_atstring date-time nullable
created_atstring date-time required
updated_atstring date-time required