Trigger Sync Configuration

Manually trigger a sync execution.

Creates a sync job and immediately dispatches it for async execution via Celery. The sync job processes files from the storage provider and creates objects in the bucket.

Execution Flow:

1. Acquires distributed lock (prevents concurrent runs)
2. Iterates files from storage provider with configured filters
3. Creates objects idempotently (skips duplicates)
4. Failed objects go to Dead Letter Queue (3 retries)
5. Creates batches for collection processing (100 objects/batch)
6. Emits metrics and releases lock

Use Cases:

• Test sync configuration after creation
• Force sync outside of scheduled intervals
• Re-sync after updating connection credentials
• Trigger incremental sync (only modified files)

Returns: sync_job_id to track progress via GET /syncs/{id}