Create import jobs and import automations

Start with a one-time import job

job = client.import_jobs.create(
    connector_id="conn_archive",
    index_id="idx_archive",
    source_prefix="incoming/2026/04/",
    file_pattern="*.mp4",
    recursive=True,
)

Poll or retrieve the job to inspect:

• progress
• imported video_ids
• failed files
• skipped files

Add an import automation

Import automations are index-level saved configurations. They require:

• connector_id
• source prefix and file pattern
• debounce_interval
• prompt_preset with at least prompt_id

{
  "enabled": true,
  "paused": false,
  "connector_id": "conn_archive",
  "source_prefix": "incoming/daily/",
  "file_pattern": "*.mp4",
  "recursive": true,
  "debounce_interval": "10m",
  "prompt_preset": {
    "prompt_id": "prompt_episode_extract"
  }
}

Debounce intervals

Supported public debounce intervals are:

• 5m
• 10m
• 1h
• 1d

Use the shortest interval that matches the business process rather than trying to simulate near-real-time internal polling behavior.

Pause and resume

Import automations can be paused and resumed without deleting the saved configuration. That is the preferred control for temporary operational freezes.