Trigger Sync Configuration

curl --request POST \
  --url https://api.mixpeek.com/v1/buckets/{bucket_id}/syncs/{sync_config_id}/trigger \
  --header 'Authorization: Bearer <token>'

{
  "status": 123,
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "details": {}
  },
  "success": false
}

Syncs

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:

Acquires distributed lock (prevents concurrent runs)
Iterates files from storage provider with configured filters
Creates objects idempotently (skips duplicates)
Failed objects go to Dead Letter Queue (3 retries)
Creates batches for collection processing (100 objects/batch)
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/

POST

buckets

{bucket_id}

syncs

{sync_config_id}

trigger

Trigger Sync Configuration

curl --request POST \
  --url https://api.mixpeek.com/v1/buckets/{bucket_id}/syncs/{sync_config_id}/trigger \
  --header 'Authorization: Bearer <token>'

{
  "status": 123,
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "details": {}
  },
  "success": false
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

bucket_id

string

required

sync_config_id

string

required

Query Parameters

full_sync

boolean

default:false

Response

Successful Response

Resume Sync Configuration Force Unlock Sync Configuration