---
title: "Trigger a manual sync of the connection"
method: POST
path: "/v1/connections/sync"
tags: ["connection"]
---

# Trigger a manual sync of the connection

`POST /v1/connections/sync`

## Request body

- ConnectionIdRequestBody
  - `connectionId` string, uuid, required

## Response `200`

Successful operation

- JobInfoRead
  - `attempts` AttemptInfoRead[], required
    - `attempt` AttemptRead, required
      - `bytesSynced` integer
      - `createdAt` integer, required
      - `endedAt` integer
      - `failureSummary` AttemptFailureSummary
        - `failures` AttemptFailureReason[], required
          - `externalMessage` string
          - `failureOrigin` 'source' | 'destination' | 'replication' | 'persistence' | 'normalization' | 'dbt' | 'airbyte_platform' | 'unknown' — Indicates where the error originated. If not set, the origin of error is not well known.
          - `failureType` 'config_error' | 'system_error' | 'manual_cancellation' | 'refresh_schema' — Categorizes well known errors into types for programmatic handling. If not set, the type of error is not well known.
          - `internalMessage` string
          - `retryable` boolean — True if it is known that retrying may succeed, e.g. for a transient failure. False if it is known that a retry will not succeed, e.g. for a configuration issue. If not set, retryable status is not well known.
          - `stacktrace` string
          - `timestamp` integer, required
        - `partialSuccess` boolean — True if the number of committed records for this attempt was greater than 0. False if 0 records were committed. If not set, the number of committed records is unknown.
      - `id` integer, required
      - `recordsSynced` integer
      - `status` 'running' | 'failed' | 'succeeded', required
      - `streamStats` AttemptStreamStats[]
        - `stats` AttemptStats, required
          - `bytesEmitted` integer
          - `estimatedBytes` integer
          - `estimatedRecords` integer
          - `recordsCommitted` integer
          - `recordsEmitted` integer
          - `stateMessagesEmitted` integer
        - `streamName` string, required
        - `streamNamespace` string
      - `totalStats` AttemptStats
        - `bytesEmitted` integer
        - `estimatedBytes` integer
        - `estimatedRecords` integer
        - `recordsCommitted` integer
        - `recordsEmitted` integer
        - `stateMessagesEmitted` integer
      - `updatedAt` integer, required
    - `logs` LogRead, required
      - `logLines` string[], required
  - `job` JobRead, required
    - `configId` string, required
    - `configType` 'check_connection_source' | 'check_connection_destination' | 'discover_schema' | 'get_spec' | 'sync' | 'reset_connection', required
    - `createdAt` integer, required
    - `id` integer, required
    - `resetConfig` ResetConfig — contains information about how a reset was configured. only populated if the job was a reset.
      - `streamsToReset` StreamDescriptor[]
        - `name` string, required
        - `namespace` string
    - `startedAt` integer
    - `status` 'pending' | 'running' | 'incomplete' | 'failed' | 'succeeded' | 'cancelled', required
    - `updatedAt` integer, required

## Other responses

- `404` — Object with given id was not found.
- `422` — Input failed validation

---

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