> ## Documentation Index
> Fetch the complete documentation index at: https://www.c1.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Sync Status

> Get current sync progress and classified, redacted errors for a connector the caller manages.



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples get /api/v1/apps/{app_id}/connectors/{connector_id}/sync_diagnostics/status
openapi: 3.1.0
info:
  description: The C1 API is a HTTP API for managing C1 resources.
  title: C1 API
  version: 0.1.0-alpha
servers:
  - description: The C1 API server for the current tenant.
    url: https://{tenantDomain}.conductor.one
    variables:
      tenantDomain:
        default: example
        description: The domain of the tenant to use for this request.
security:
  - bearerAuth: []
    oauth: []
paths:
  /api/v1/apps/{app_id}/connectors/{connector_id}/sync_diagnostics/status:
    get:
      tags:
        - Connector Sync Diagnostics
      summary: Get Sync Status
      description: >-
        Get current sync progress and classified, redacted errors for a
        connector the caller manages.
      operationId: c1.api.app.v1.ConnectorSyncDiagnosticsService.GetSyncStatus
      parameters:
        - in: path
          name: app_id
          required: true
          schema:
            description: Application containing the connector.
            type: string
        - in: path
          name: connector_id
          required: true
          schema:
            description: Connector whose status is requested.
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/c1.api.app.v1.GetSyncStatusResponse'
          description: GetSyncStatusResponse contains the current diagnostic status.
      x-codeSamples:
        - lang: go
          label: GetSyncStatus
          source: "package main\n\nimport(\n\t\"context\"\n\t\"github.com/conductorone/conductorone-sdk-go/pkg/models/shared\"\n\tconductoronesdkgo \"github.com/conductorone/conductorone-sdk-go\"\n\t\"github.com/conductorone/conductorone-sdk-go/pkg/models/operations\"\n\t\"log\"\n)\n\nfunc main() {\n    ctx := context.Background()\n\n    s := conductoronesdkgo.New(\n        conductoronesdkgo.WithSecurity(shared.Security{\n            BearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n            Oauth: \"<YOUR_OAUTH_HERE>\",\n        }),\n    )\n\n    res, err := s.ConnectorSyncDiagnostics.GetSyncStatus(ctx, operations.C1APIAppV1ConnectorSyncDiagnosticsServiceGetSyncStatusRequest{\n        AppID: \"<id>\",\n        ConnectorID: \"<id>\",\n    })\n    if err != nil {\n        log.Fatal(err)\n    }\n    if res.GetSyncStatusResponse != nil {\n        // handle response\n    }\n}"
components:
  schemas:
    c1.api.app.v1.GetSyncStatusResponse:
      description: GetSyncStatusResponse contains the current diagnostic status.
      properties:
        status:
          oneOf:
            - $ref: '#/components/schemas/c1.api.app.v1.SyncStatusView'
            - type: 'null'
      title: Get Sync Status Response
      type: object
      x-speakeasy-name-override: GetSyncStatusResponse
    c1.api.app.v1.SyncStatusView:
      description: >-
        SyncStatusView contains diagnostic progress without pagination tokens or
        configuration.
      properties:
        attempts:
          description: Attempts at the current step.
          format: uint32
          type: integer
        configUpdatedAt:
          format: date-time
          type:
            - string
            - 'null'
        debugMode:
          description: Whether connector debug logging is currently enabled.
          type: boolean
        errorClass:
          description: Classification of the current error.
          enum:
            - SYNC_ERROR_CLASS_UNSPECIFIED
            - SYNC_ERROR_CLASS_AUTH_OR_SCOPE
            - SYNC_ERROR_CLASS_RATE_LIMIT
            - SYNC_ERROR_CLASS_TIMEOUT
            - SYNC_ERROR_CLASS_UPSTREAM_CONSISTENCY
            - SYNC_ERROR_CLASS_CONNECTOR_BUG
            - SYNC_ERROR_CLASS_STORAGE
            - SYNC_ERROR_CLASS_DATA_ANOMALY
            - SYNC_ERROR_CLASS_RUNTIME_REFUSED
            - SYNC_ERROR_CLASS_DEPLOYMENT
            - SYNC_ERROR_CLASS_UNKNOWN
          type: string
          x-speakeasy-unknown-values: allow
        errorKind:
          description: Structured error kind name.
          type: string
        lastError:
          description: Redacted current error, capped at 256 bytes.
          type: string
        liveCounts:
          additionalProperties:
            format: int64
            type: string
          description: Aggregate live counts for known count categories only.
          type: object
        schedule:
          description: Current sync schedule name.
          type: string
        startedAt:
          format: date-time
          type:
            - string
            - 'null'
        status:
          description: Current sync status.
          enum:
            - SYNC_STATUS_UNSPECIFIED
            - SYNC_STATUS_RUNNING
            - SYNC_STATUS_DONE
            - SYNC_STATUS_ERROR
            - SYNC_STATUS_DISABLED
          type: string
          x-speakeasy-unknown-values: allow
        step:
          description: Current sync step name.
          type: string
        stepState:
          description: Current phase of the sync step.
          type: string
        syncDisabledCategory:
          description: Category explaining why syncing is disabled.
          type: string
        syncDisabledReason:
          description: Redacted reason syncing is disabled, capped at 256 bytes.
          type: string
        upliftCompletedCount:
          description: Completed uplift actions, when available.
          format: int64
          type: string
        upliftTotalCount:
          description: Total uplift actions, when available.
          format: int64
          type: string
      title: Sync Status View
      type: object
      x-speakeasy-name-override: SyncStatusView
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    oauth:
      description: >-
        This API uses OAuth2 with the Client Credential flow.

        Client Credentials must be sent in the BODY, not the headers.

        For an example of how to implement this, refer to the
        [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187)
        function.
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: /auth/v1/token
      type: oauth2

````