> ## 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 Change Timeline

> Get a bounded metadata-only timeline of configuration, release and deployment changes around sync failures.



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples post /api/v1/apps/{app_id}/connectors/{connector_id}/sync_diagnostics/change_timeline
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/change_timeline:
    post:
      tags:
        - Connector Sync Diagnostics
      summary: Get Sync Change Timeline
      description: >-
        Get a bounded metadata-only timeline of configuration, release and
        deployment changes around sync failures.
      operationId: c1.api.app.v1.ConnectorSyncDiagnosticsService.GetSyncChangeTimeline
      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 metadata changes are requested.
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/c1.api.app.v1.GetSyncChangeTimelineRequestInput
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.app.v1.GetSyncChangeTimelineResponse
          description: >-
            GetSyncChangeTimelineResponse contains the observed window and
            explicitly incomplete source coverage.
      x-codeSamples:
        - lang: go
          label: GetSyncChangeTimeline
          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.GetSyncChangeTimeline(ctx, operations.C1APIAppV1ConnectorSyncDiagnosticsServiceGetSyncChangeTimelineRequest{\n        AppID: \"<id>\",\n        ConnectorID: \"<id>\",\n    })\n    if err != nil {\n        log.Fatal(err)\n    }\n    if res.GetSyncChangeTimelineResponse != nil {\n        // handle response\n    }\n}"
components:
  schemas:
    c1.api.app.v1.GetSyncChangeTimelineRequestInput:
      description: >-
        GetSyncChangeTimelineRequest selects the metadata change window for a
        connector.
      properties:
        since:
          format: date-time
          type:
            - string
            - 'null'
      title: Get Sync Change Timeline Request
      type: object
      x-speakeasy-name-override: GetSyncChangeTimelineRequest
    c1.api.app.v1.GetSyncChangeTimelineResponse:
      description: >-
        GetSyncChangeTimelineResponse contains the observed window and
        explicitly incomplete source coverage.
      properties:
        events:
          description: >-
            Events ordered oldest first, capped to the most recent 100 events in
            the window.
          items:
            $ref: '#/components/schemas/c1.api.app.v1.SyncChangeTimelineEvent'
          type:
            - array
            - 'null'
        since:
          format: date-time
          type:
            - string
            - 'null'
        truncatedSources:
          description: >-
            Incomplete sources due to scan/output/retention/baseline limits;
            authored_catalog_events can omit older catalog events when other
            tenant activity fills its 250-event scan budget.
          items:
            type: string
          type:
            - array
            - 'null'
        until:
          format: date-time
          type:
            - string
            - 'null'
      title: Get Sync Change Timeline Response
      type: object
      x-speakeasy-name-override: GetSyncChangeTimelineResponse
    c1.api.app.v1.SyncChangeTimelineEvent:
      description: >-
        SyncChangeTimelineEvent describes metadata changes without configuration
        values or operator reason text.
      properties:
        activationEpoch:
          description: Recorded activation epoch, when applicable.
          format: uint64
          type: string
        actorId:
          description: Validated ConductorOne actor identifier, when available.
          type: string
        authoringEventType:
          description: Authored transition type, populated for an authored revision event.
          enum:
            - AUTHORED_EVENT_TYPE_UNSPECIFIED
            - AUTHORED_EVENT_TYPE_REVISION_ACTIVATED
            - AUTHORED_EVENT_TYPE_ROLLED_BACK
            - AUTHORED_EVENT_TYPE_SUSPENDED
            - AUTHORED_EVENT_TYPE_RESUMED
            - AUTHORED_EVENT_TYPE_RUNTIME_DEPLOYMENT_CHANGED
            - AUTHORED_EVENT_TYPE_INSTALLATION_LOST
            - AUTHORED_EVENT_TYPE_YANKED
          type: string
          x-speakeasy-unknown-values: allow
        changedKeys:
          description: Changed configuration field names, never their values.
          items:
            type: string
          type:
            - array
            - 'null'
        estimated:
          description: >-
            True for an estimated onset or an update whose precise changed
            fields are unavailable.
          type: boolean
        incompleteSource:
          description: >-
            Source with incomplete baseline information for this event, when
            applicable.
          type: string
        kind:
          description: Classification of the observed metadata change.
          enum:
            - EVENT_KIND_UNSPECIFIED
            - EVENT_KIND_CONFIG_UPDATED
            - EVENT_KIND_SYNC_RESOURCE_TYPES_UPDATED
            - EVENT_KIND_RELEASE_VERSION_CHANGED
            - EVENT_KIND_AUTHORED_REVISION_EVENT
            - EVENT_KIND_ACTIVATION_BINDING_SEALED
            - EVENT_KIND_CURRENT_SYNC_DISABLED
          type: string
          x-speakeasy-unknown-values: allow
        occurredAt:
          format: date-time
          type:
            - string
            - 'null'
        priorReleaseVersion:
          description: Release used by its predecessor lifecycle.
          type: string
        priorRevisionId:
          description: Prior revision associated with an authored change.
          type: string
        releaseVersion:
          description: Release used by the newer lifecycle.
          type: string
        revisionId:
          description: Revision associated with an authored change.
          type: string
        syncDisabledCategory:
          description: Current sync-disabled category; not an exact transition history.
          enum:
            - DISABLED_CATEGORY_UNSPECIFIED
            - DISABLED_CATEGORY_OPERATIONS
            - DISABLED_CATEGORY_CUSTOMER_OPT_OUT
            - DISABLED_CATEGORY_DEPLOYMENT
            - DISABLED_CATEGORY_DATA_ANOMALY
          type: string
          x-speakeasy-unknown-values: allow
      title: Sync Change Timeline Event
      type: object
      x-speakeasy-name-override: SyncChangeTimelineEvent
  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

````