Harness · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Harness Filter APIs API

5 actions 5 updates phrasing extends openapi/harness-filter-apis-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 5

$.info
$.paths['/gateway/lw/api/accounts/{account_id}/v1/filters'].post
$.paths['/gateway/lw/api/accounts/{account_id}/v1/filters/regions'].post
$.paths['/gateway/lw/api/accounts/{account_id}/v1/filters/instancefamilies'].post
$.paths['/gateway/lw/api/accounts/{account_id}/v1/filters/provideraccounts'].post

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 Filter APIs API
  version: 1.0.0
extends: openapi/harness-filter-apis-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['/gateway/lw/api/accounts/{account_id}/v1/filters'].post
  update:
    x-apievangelist-phrasing:
      intent: Get all commitment filter options
      effect: read
      questions:
      - What regions, instance families and provider accounts can I filter commitments by?
      - Can I get every filter option for a date range in one call?
      instructions:
      - text: Get all filter options for account {account}.
        slots:
          account: path.account_id
      - text: Fetch every filter option for {account} from {start} to {end}.
        slots:
          account: path.account_id
          start: query.start_date
          end: query.end_date
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/lw/api/accounts/{account_id}/v1/filters/regions'].post
  update:
    x-apievangelist-phrasing:
      intent: List available regions for filtering
      effect: read
      questions:
      - Which AWS regions have usage I can filter on?
      - What regions are available for a given service?
      instructions:
      - text: List available regions for account {account}.
        slots:
          account: path.account_id
      - text: Show regions for service {service} in account {account}.
        slots:
          service: query.service
          account: path.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/lw/api/accounts/{account_id}/v1/filters/instancefamilies'].post
  update:
    x-apievangelist-phrasing:
      intent: List available instance families
      effect: read
      questions:
      - Which instance families appear in my usage for filtering?
      - What instance families were used in a given date range?
      instructions:
      - text: List instance families for account {account}.
        slots:
          account: path.account_id
      - text: Show instance families in {account} between {start} and {end}.
        slots:
          account: path.account_id
          start: query.start_date
          end: query.end_date
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/lw/api/accounts/{account_id}/v1/filters/provideraccounts'].post
  update:
    x-apievangelist-phrasing:
      intent: List cloud provider account IDs for filtering
      effect: read
      questions:
      - Which cloud provider account IDs can I filter by?
      - What linked cloud accounts have data for this period?
      instructions:
      - text: List provider account IDs for account {account}.
        slots:
          account: path.account_id
      - text: Show cloud provider accounts with {service} usage in {account}.
        slots:
          service: query.service
          account: path.account_id
      method: generated
      generated: '2026-09-26'