Harness · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Harness Recommendation Ignore List API

4 actions 4 updates phrasing extends openapi/harness-recommendation-ignore-list-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 4

$.info

$.paths['/ccm/api/recommendation/ignore-list/add'].post

$.paths['/ccm/api/recommendation/ignore-list'].get

$.paths['/ccm/api/recommendation/ignore-list/remove'].post

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Recommendation Ignore List API
  version: 1.0.0
extends: openapi/harness-recommendation-ignore-list-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: 3
- target: $.paths['/ccm/api/recommendation/ignore-list/add'].post
  update:
    x-apievangelist-phrasing:
      intent: Ignore resources in cost recommendations
      effect: write
      questions:
      - Can I stop getting cost recommendations for specific workloads or EC2 instances?
      - Is it possible to ignore a resource's recommendations for a limited number of days?
      instructions:
      - text: Add EC2 instances {instances} to the recommendations ignore list in account {account}.
        slots:
          instances: requestBody.ec2Instances
          account: query.accountIdentifier
      - text: Ignore recommendations for workloads {workloads} for {days} days in account {account}.
        slots:
          workloads: requestBody.workloads
          days: requestBody.durationInDays
          account: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/recommendation/ignore-list'].get
  update:
    x-apievangelist-phrasing:
      intent: List resources ignored in recommendations
      effect: read
      questions:
      - Which resources am I currently ignoring in cost recommendations?
      - What's on my recommendations ignore list right now?
      instructions:
      - text: Show the recommendations ignore list for account {account}.
        slots:
          account: query.accountIdentifier
      - text: List every resource excluded from recommendations in account {account}.
        slots:
          account: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/recommendation/ignore-list/remove'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop ignoring resources in recommendations
      effect: write
      questions:
      - How do I start getting recommendations again for a resource I ignored?
      - Can I take Azure VMs back off the recommendations ignore list?
      instructions:
      - text: Remove EC2 instances {instances} from the recommendations ignore list in account {account}.
        slots:
          instances: requestBody.ec2Instances
          account: query.accountIdentifier
      - text: Un-ignore Azure VMs {vms} so they get recommendations again in account {account}.
        slots:
          vms: requestBody.azureVmIds
          account: query.accountIdentifier
      method: generated
      generated: '2026-09-26'