API Evangelist conversational phrasing for Harness Connectors API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Connectors API
  version: 1.0.0
extends: openapi/harness-connectors-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: 16
- target: $.paths['/ng/api/connectors/ccmK8sList'].post
  update:
    x-apievangelist-phrasing:
      intent: List cloud cost Kubernetes connectors
      effect: read
      questions:
      - Which Kubernetes connectors are set up for cloud cost management in my account?
      - Can I filter my CCM Kubernetes connectors by connectivity status or tags?
      instructions:
      - text: List the CCM Kubernetes connectors in project {project}.
        slots:
          project: query.projectIdentifier
      - text: Find cost-management Kubernetes connectors whose name matches {term}.
        slots:
          term: query.searchTerm
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/connectors'].get
  update:
    x-apievangelist-phrasing:
      intent: List connectors with simple filters
      effect: read
      questions:
      - What connectors exist in my Harness project?
      - Can I list only connectors of one type, like Git or cloud provider?
      - Is there a way to page through connectors by category?
      instructions:
      - text: List connectors of type {type} in project {project}.
        slots:
          type: query.type
          project: query.projectIdentifier
      - text: Show connectors in category {category}, page {page}.
        slots:
          category: query.category
          page: query.pageIndex
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/connectors'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an existing connector
      effect: write
      questions:
      - How do I change the credentials or settings of a connector I already created?
      - Can I commit a connector change to a Git branch when it is stored in Git?
      instructions:
      - text: 'Update the connector with this definition: {connector}.'
        slots:
          connector: requestBody.connector
      - text: Save the connector change {connector} to branch {branch} with commit message {message}.
        slots:
          connector: requestBody.connector
          branch: query.branch
          message: query.commitMsg
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/connectors'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new connector
      effect: write
      questions:
      - How do I create a connector so Harness can reach my cloud, Git or artifact repository?
      - Can a new connector's YAML be stored in a Git repository instead of Harness?
      instructions:
      - text: Create a new connector from {connector}.
        slots:
          connector: requestBody.connector
      - text: Create connector {connector} and store it in repo {repo} on branch {branch}.
        slots:
          connector: requestBody.connector
          repo: query.repoName
          branch: query.branch
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/connectors/{identifier}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a connector's details
      effect: read
      questions:
      - How do I see the configuration of one connector by its ID?
      - What type and credentials reference does a specific connector use?
      instructions:
      - text: Get the details of connector {connector_id}.
        slots:
          connector_id: path.identifier
      - text: Show connector {connector_id} in project {project}.
        slots:
          connector_id: path.identifier
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/connectors/{identifier}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a connector
      effect: destructive
      questions:
      - How do I delete a connector I no longer need?
      - Can I force-delete a connector that other entities still reference?
      instructions:
      - text: Delete connector {connector_id}.
        slots:
          connector_id: path.identifier
      - text: Force-delete connector {connector_id} from project {project}, force {force}.
        slots:
          connector_id: path.identifier
          project: query.projectIdentifier
          force: query.forceDelete
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/connectors/fieldValues'].get
  update:
    x-apievangelist-phrasing:
      intent: Get allowed field values for a connector type
      effect: read
      questions:
      - What values can I pick for fields when creating a connector of a given type?
      - Which auth types and options are allowed for a particular connector type?
      instructions:
      - text: List the allowed field values for connector type {type}.
        slots:
          type: query.connectorType
      - text: Show which options I can set when creating a {type} connector.
        slots:
          type: query.connectorType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/connectors/getceawstemplateurl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the AWS cost connector CloudFormation template URL
      effect: read
      questions:
      - Where is the AWS CloudFormation template I need to set up a cloud cost connector?
      - Can the AWS cost template include cost and usage reports and optimization permissions?
      instructions:
      - text: Get the AWS cost connector template URL with CUR enabled {cur}.
        slots:
          cur: query.curEnabled
      - text: Fetch the AWS cost template URL with optimization {optimization} and events {events}.
        slots:
          optimization: query.optimizationEnabled
          events: query.eventsEnabled
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/connectors/catalogue'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse the catalogue of connector types
      effect: read
      questions:
      - What kinds of connectors can I create in Harness?
      - Which connector types are grouped under each category in the catalogue?
      instructions:
      - text: Show the connector catalogue for my account.
      - text: List every connector type available to create, by category.
      - text: Pull the catalogue of connector types available to account {account}.
        slots:
          account: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/connectors/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get connector statistics
      effect: read
      questions:
      - How many connectors do I have by type and by connection status?
      - Can I see connector statistics scoped to one project?
      instructions:
      - text: Show connector statistics for project {project}.
        slots:
          project: query.projectIdentifier
      - text: Give me connector counts by type and status for org {org}.
        slots:
          org: query.orgIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/connectors/{connectorRef}/gcp-projects'].get
  update:
    x-apievangelist-phrasing:
      intent: List GCP projects a connector can access
      effect: read
      questions:
      - Which GCP projects can my Google Cloud connector see?
      - Can I check the GCP project IDs a connector has access to?
      instructions:
      - text: List the GCP projects reachable through connector {connector}.
        slots:
          connector: path.connectorRef
      - text: Show GCP project IDs for connector {connector} in project {project}.
        slots:
          connector: path.connectorRef
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/connectors/listV2'].post
  update:
    x-apievangelist-phrasing:
      intent: Search connectors with advanced filter criteria
      effect: read
      questions:
      - Can I find connectors by connectivity status, tags or category in one query?
      - Is there a way to list only my favorite connectors?
      - Which connectors are failing to connect right now?
      instructions:
      - text: Find connectors with connectivity status {statuses}.
        slots:
          statuses: requestBody.connectivityStatuses
      - text: Filter connectors by types {types} and tags {tags}.
        slots:
          types: requestBody.types
          tags: requestBody.tags
      - text: 'List only my favorite connectors: favorites {favorites}.'
        slots:
          favorites: query.onlyFavorites
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/connectors/listbyfqn'].post
  update:
    x-apievangelist-phrasing:
      intent: Look up connectors by fully qualified name
      effect: read
      questions:
      - Can I resolve a batch of connector fully qualified names to connectors?
      - How many FQNs can I look up in one connector request?
      instructions:
      - text: Look up these connectors by their fully qualified names.
      - text: Resolve my list of connector FQNs to connector records.
      - text: Resolve connector FQNs within account {account}.
        slots:
          account: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/connectors/testConnection/{identifier}'].post
  update:
    x-apievangelist-phrasing:
      intent: Test a connector's connection
      effect: read
      questions:
      - How do I check that a connector can actually reach the third-party tool?
      - Why would a connector show as disconnected, and can I retest it?
      instructions:
      - text: Test the connection for connector {connector_id}.
        slots:
          connector_id: path.identifier
      - text: Re-run the connectivity test on connector {connector_id} in project {project}.
        slots:
          connector_id: path.identifier
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/connectors/testGitRepoConnection/{identifier}'].post
  update:
    x-apievangelist-phrasing:
      intent: Test a Git connector against a repository
      effect: read
      questions:
      - Can my Git connector reach a specific repository URL?
      - How do I verify a Git connector syncs with one repo before using it?
      instructions:
      - text: Test Git connector {connector_id} against repo {repo_url}.
        slots:
          connector_id: path.identifier
          repo_url: query.repoURL
      - text: Check that Git connector {connector_id} can sync with its repository.
        slots:
          connector_id: path.identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/connectors/validateUniqueIdentifier'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether a connector identifier is free
      effect: read
      questions:
      - Is a connector identifier already taken in my project?
      - Can I check an ID is unique before creating a connector?
      instructions:
      - text: Check if connector identifier {identifier} is unique.
        slots:
          identifier: query.identifier
      - text: Verify no connector in project {project} already uses ID {identifier}.
        slots:
          project: query.projectIdentifier
          identifier: query.identifier
      method: generated
      generated: '2026-09-26'