Harness · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Harness Git Sync API

6 actions 6 updates phrasing extends openapi/harness-git-sync-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Harness's API. It is a proposal applied on top of the contract, not a document Harness publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 6

$.info
$.paths['/ng/api/git-sync'].get
$.paths['/ng/api/git-sync'].put
$.paths['/ng/api/git-sync'].post
$.paths['/ng/api/git-sync/git-sync-enabled'].get
$.paths['/ng/api/git-sync/{identifier}/folder/{folderIdentifier}/default'].put

OpenAPI Overlay

Raw ↑
# 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 API
  version: 1.0.0
extends: openapi/harness-git-sync-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: 5
- target: $.paths['/ng/api/git-sync'].get
  update:
    x-apievangelist-phrasing:
      intent: List Git Sync configurations
      effect: read
      questions:
      - Which Git repositories are configured for Git Sync in my project?
      - Can I see the Git Sync configs at the org level?
      instructions:
      - text: List Git Sync configs in project {project}.
        slots:
          project: query.projectIdentifier
      - text: Show all Git Sync configurations for account {account}.
        slots:
          account: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/git-sync'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a Git Sync configuration
      effect: write
      questions:
      - Can I switch an existing Git Sync config to a different branch?
      - How do I point Git Sync at a new connector for the same repo?
      instructions:
      - text: Update Git Sync config {identifier} to sync branch {branch}.
        slots:
          identifier: requestBody.identifier
          branch: requestBody.branch
      - text: Change Git Sync config {identifier} to use connector {gitConnectorRef}.
        slots:
          identifier: requestBody.identifier
          gitConnectorRef: requestBody.gitConnectorRef
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/git-sync'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Git Sync configuration
      effect: write
      questions:
      - How do I connect a Git repo so Harness entities sync to it?
      - What do I need, like a connector and branch, to set up Git Sync?
      instructions:
      - text: Set up Git Sync {name} for repo {repo} on branch {branch} via connector {gitConnectorRef}.
        slots:
          name: requestBody.name
          repo: requestBody.repo
          branch: requestBody.branch
          gitConnectorRef: requestBody.gitConnectorRef
      - text: Create a new Git Sync config {identifier} of type {gitConnectorType}.
        slots:
          identifier: requestBody.identifier
          gitConnectorType: requestBody.gitConnectorType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/git-sync/git-sync-enabled'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether Git Sync is enabled
      effect: read
      questions:
      - Is Git Sync turned on for my project?
      - Does a given org have Git Sync enabled?
      instructions:
      - text: Check if Git Sync is enabled in project {project}.
        slots:
          project: query.projectIdentifier
      - text: Tell me whether account {account} has Git Sync enabled.
        slots:
          account: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/git-sync/{identifier}/folder/{folderIdentifier}/default'].put
  update:
    x-apievangelist-phrasing:
      intent: Set the default root folder for Git Sync
      effect: write
      questions:
      - Can I change which folder in the repo Git Sync uses by default?
      - How do I set a different default root folder for a Git Sync config?
      instructions:
      - text: Make folder {folderIdentifier} the default root folder for Git Sync config {identifier}.
        slots:
          folderIdentifier: path.folderIdentifier
          identifier: path.identifier
      - text: Set Git Sync config {identifier}'s default folder to {folderIdentifier}.
        slots:
          identifier: path.identifier
          folderIdentifier: path.folderIdentifier
      method: generated
      generated: '2026-09-26'