---
title: "Run Sync"
method: POST
path: "/source-connections/{source_connection_id}/run"
tags: ["source-connections"]
---

# Run Sync

`POST /source-connections/{source_connection_id}/run`

Trigger a data synchronization job for a source connection.

Starts an asynchronous sync job that pulls the latest data from the connected
source. The job runs in the background and you can monitor its progress using
the jobs endpoint.

For continuous sync connections, this performs an incremental sync by default.
Use `force_full_sync=true` to perform a complete re-sync of all data.

## Path parameters

- `source_connection_id` string, uuid, required — Unique identifier of the source connection to sync (UUID)

## Query parameters

- `force_full_sync` boolean — Force a full sync ignoring cursor data. Only applies to continuous sync connections. Non-continuous connections always perform full syncs.

## Response `200`

Created sync job

- SourceConnectionJob — A sync job representing a single synchronization run. Sync jobs track the execution of data synchronization from a source connection. Each job includes timing information, entity counts, and error details if applicable.
  - `id` string, uuid, required — Unique identifier of the sync job
  - `source_connection_id` string, uuid, required — ID of the source connection this job belongs to
  - `status` 'created' | 'pending' | 'running' | 'completed' | 'failed' | 'cancelling' | 'cancelled', required — Sync job status enum.
  - `started_at` string, date-time, nullable — When the job started execution (ISO 8601)
  - `completed_at` string, date-time, nullable — When the job finished (ISO 8601). Null if still running.
  - `duration_seconds` number, nullable — Total execution time in seconds. Null if still running.
  - `entities_inserted` integer — Number of new entities created during this sync
  - `entities_updated` integer — Number of existing entities updated during this sync
  - `entities_deleted` integer — Number of entities removed during this sync
  - `entities_failed` integer — Number of entities that failed to process
  - `error` string, nullable — Error message if the job failed
  - `error_details` object, nullable — Additional error context for debugging

## Other responses

- `404` — Source Connection Not Found
- `409` — Sync Already Running
- `422` — Validation Error
- `429` — Rate Limit Exceeded

---

[API](https://skmtc.net/airweave-ai/apis/airweave.md) · [All operations](https://skmtc.net/airweave-ai/apis/airweave/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/airweave-ai/airweave/versions/bf410c28c0c6/schema)