# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Service Overrides API
  version: 1.0.0
extends: openapi/harness-serviceoverrides-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: 6
- target: $.paths['/ng/api/serviceOverrides'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an existing service override
      effect: write
      questions:
      - How do I change the values of a service override I already created?
      - Can I edit the YAML of an existing environment or infrastructure override?
      instructions:
      - text: Update the {type} override for environment {environment} and service {service} with YAML {yaml}.
        slots:
          type: requestBody.type
          environment: requestBody.environmentRef
          service: requestBody.serviceRef
          yaml: requestBody.yaml
      - text: Edit existing override {override} in environment {environment} (type {type}).
        slots:
          override: requestBody.identifier
          environment: requestBody.environmentRef
          type: requestBody.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/serviceOverrides'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a service override for an environment
      effect: write
      questions:
      - How do I override a service's variables or manifests for one environment?
      - Can I create an override scoped to a specific infrastructure?
      instructions:
      - text: Create a {type} override for service {service} in environment {environment}.
        slots:
          type: requestBody.type
          service: requestBody.serviceRef
          environment: requestBody.environmentRef
      - text: Add a new override of type {type} on infrastructure {infra} in environment {environment}.
        slots:
          type: requestBody.type
          infra: requestBody.infraIdentifier
          environment: requestBody.environmentRef
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/serviceOverrides/{identifier}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a service override by identifier
      effect: read
      questions:
      - What values does a particular service override apply?
      - Can I look up a service override by its identifier?
      instructions:
      - text: Get service override {override}.
        slots:
          override: path.identifier
      - text: Show override {override} in project {project}.
        slots:
          override: path.identifier
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/serviceOverrides/{identifier}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a service override
      effect: destructive
      questions:
      - How do I remove a service override so the defaults apply again?
      - Is deleting a service override reversible?
      instructions:
      - text: Delete service override {override}.
        slots:
          override: path.identifier
      - text: Remove override {override} from project {project}.
        slots:
          override: path.identifier
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/serviceOverrides/move-config'].post
  update:
    x-apievangelist-phrasing:
      intent: Move a service override between inline and git
      effect: write
      questions:
      - Can I move a service override's YAML out of Harness and into a git repo?
      - How do I bring a remote service override back inline?
      instructions:
      - text: Move override {override} to git repo {repo} at {file_path} on branch {branch}.
        slots:
          override: query.identifier
          repo: query.repoName
          file_path: query.filePath
          branch: query.branch
      - text: Apply move type {move_type} to service override {override}.
        slots:
          move_type: query.moveConfigType
          override: query.identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ng/api/serviceOverrides/update-git-metadata'].put
  update:
    x-apievangelist-phrasing:
      intent: Update the git metadata of a remote service override
      effect: write
      questions:
      - I renamed the repo holding my service override - how do I relink it?
      - Can I change the connector or file path a remote override points to?
      instructions:
      - text: Point remote override {override} at repo {repo} and file {file_path}.
        slots:
          override: query.identifier
          repo: query.repoName
          file_path: query.filePath
      - text: Change the git connector of service override {override} to {connector}.
        slots:
          override: query.identifier
          connector: query.connectorRef
      method: generated
      generated: '2026-09-26'