Sign in

v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-222763184.3 KB
source-connections

List Sync Jobs

Retrieve the sync job history for a source connection.

Returns a list of sync jobs ordered by creation time (newest first). Each job includes status, timing information, and entity counts.

Job statuses:

  • PENDING: Job is queued, waiting for the worker to pick it up
  • RUNNING: Sync is actively pulling and processing data
  • COMPLETED: Sync finished successfully
  • FAILED: Sync encountered an unrecoverable error
  • CANCELLING: Cancellation has been requested. The worker is gracefully stopping the pipeline and cleaning up destination data.
  • CANCELLED: Sync was cancelled. The worker has fully stopped and destination data cleanup has been scheduled.
get/source-connections/{source_connection_id}/jobs

Path parameters

source_connection_idstring uuid required

Unique identifier of the source connection (UUID)

Example:550e8400-e29b-41d4-a716-446655440000

Unique identifier of the source connection (UUID)

Query parameters

limitinteger

Maximum number of jobs to return (1-1000)

Example:100

Maximum number of jobs to return (1-1000)

Response

List of sync jobs

idstring uuid required

Unique identifier of the sync job

source_connection_idstring 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_atstring date-time nullable

When the job started execution (ISO 8601)

completed_atstring date-time nullable

When the job finished (ISO 8601). Null if still running.

duration_secondsnumber nullable

Total execution time in seconds. Null if still running.

entities_insertedinteger

Number of new entities created during this sync

entities_updatedinteger

Number of existing entities updated during this sync

entities_deletedinteger

Number of entities removed during this sync

entities_failedinteger

Number of entities that failed to process

errorstring nullable

Error message if the job failed

error_detailsobject nullable

Additional error context for debugging

Example response

[
  {
    "completed_at": "2024-03-15T12:05:32Z",
    "duration_seconds": 332.5,
    "entities_deleted": 3,
    "entities_failed": 0,
    "entities_inserted": 45,
    "entities_updated": 12,
    "id": "770e8400-e29b-41d4-a716-446655440002",
    "source_connection_id": "550e8400-e29b-41d4-a716-446655440000",
    "started_at": "2024-03-15T12:00:00Z",
    "status": "COMPLETED"
  }
]