# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Git Sync Errors API
  version: 1.0.0
extends: openapi/harness-git-sync-errors-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/ng/api/git-sync-errors/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count Git sync errors for a repo and branch
      effect: read
      questions:
      - How many Git sync errors do we have on a branch?
      - Can I get just the error count for one repository?
      instructions:
      - text: Count Git sync errors for repo {repoIdentifier} on branch {branch}.
        slots:
          repoIdentifier: query.repoIdentifier
          branch: query.branch
      - text: Give me the number of sync errors in account {accountIdentifier}.
        slots:
          accountIdentifier: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/git-sync-errors'].get
  update:
    x-apievangelist-phrasing:
      intent: List Git sync errors by file or connectivity
      effect: read
      questions:
      - Which files failed to sync from Git into Harness?
      - Can I see connectivity errors separately from file errors?
      instructions:
      - text: List Git sync errors for repo {repoIdentifier} on branch {branch}.
        slots:
          repoIdentifier: query.repoIdentifier
          branch: query.branch
      - text: Show Git-to-Harness file errors matching {searchTerm} in account {accountIdentifier}.
        slots:
          searchTerm: query.searchTerm
          accountIdentifier: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/git-sync-errors/commits/{commitId}'].get
  update:
    x-apievangelist-phrasing:
      intent: List Git sync errors for a commit
      effect: read
      questions:
      - What sync errors did a specific commit cause?
      - Did a given commit fail to sync into Harness?
      instructions:
      - text: List Git-to-Harness errors for commit {commitId}.
        slots:
          commitId: path.commitId
      - text: Show sync errors from commit {commitId} in repo {repoIdentifier}.
        slots:
          commitId: path.commitId
          repoIdentifier: query.repoIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/git-sync-errors/aggregate'].get
  update:
    x-apievangelist-phrasing:
      intent: List Git sync errors grouped by commit
      effect: read
      questions:
      - Which commits have Git sync errors and how many each?
      - Can I get a per-commit summary of Git-to-Harness errors?
      instructions:
      - text: Group Git sync errors by commit for repo {repoIdentifier} on branch {branch}.
        slots:
          repoIdentifier: query.repoIdentifier
          branch: query.branch
      - text: Summarize errors per commit with {numberOfErrorsInSummary} errors shown for each.
        slots:
          numberOfErrorsInSummary: query.numberOfErrorsInSummary
      method: generated
      generated: '2026-09-26'