Harness · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Harness RI Inventory APIs API

4 actions 4 updates phrasing extends openapi/harness-ri-inventory-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 4

$.info

$.paths['/gateway/lw/api/accounts/{account_id}/v2/inventory/ri/list'].post

$.paths['/gateway/lw/api/accounts/{account_id}/v2/inventory/ri/{riId}/detail'].get

$.paths['/gateway/lw/api/accounts/{account_id}/v2/filters/ri'].get

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 RI Inventory APIs API
  version: 1.0.0
extends: openapi/harness-ri-inventory-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: 3
- target: $.paths['/gateway/lw/api/accounts/{account_id}/v2/inventory/ri/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List Reserved Instances
      effect: read
      questions:
      - Which Reserved Instances do I own across my cloud accounts?
      - Can I filter and sort my Reserved Instance inventory?
      instructions:
      - text: List Reserved Instances in account {account}.
        slots:
          account: path.account_id
      - text: Show Reserved Instances in {account} matching filters {filters} sorted by {sort}.
        slots:
          account: path.account_id
          filters: requestBody.filters
          sort: requestBody.sort_by
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/lw/api/accounts/{account_id}/v2/inventory/ri/{riId}/detail'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a Reserved Instance
      effect: read
      questions:
      - What are the term, payment option and utilization of a specific Reserved Instance?
      - Can I look up one RI by its ID?
      instructions:
      - text: Get details for Reserved Instance {ri} in account {account}.
        slots:
          ri: path.riId
          account: path.account_id
      - text: Show everything about RI {ri}.
        slots:
          ri: path.riId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/lw/api/accounts/{account_id}/v2/filters/ri'].get
  update:
    x-apievangelist-phrasing:
      intent: Get filter options for Reserved Instances
      effect: read
      questions:
      - What instance types, platforms and accounts can I filter Reserved Instances by?
      - Which RI filter values are available for a service?
      instructions:
      - text: Get Reserved Instance filter options for account {account}.
        slots:
          account: path.account_id
      - text: Show RI filter values for service {service} in {account}.
        slots:
          service: query.service
          account: path.account_id
      method: generated
      generated: '2026-09-26'