Harness · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Harness SP Inventory APIs API

4 actions 4 updates phrasing extends openapi/harness-sp-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/sp/list'].post

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

$.paths['/gateway/lw/api/accounts/{account_id}/v2/filters/sp'].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 SP Inventory APIs API
  version: 1.0.0
extends: openapi/harness-sp-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/sp/list'].post
  update:
    x-apievangelist-phrasing:
      intent: List Savings Plans in inventory
      effect: read
      questions:
      - Which Savings Plans does my cloud account hold?
      - Can I filter Savings Plans by a date range?
      instructions:
      - text: List Savings Plans for account {account_id} with routing id {routing_id}.
        slots:
          account_id: path.account_id
          routing_id: query.routingId
      - text: Show Savings Plans between {start_date} and {end_date} for account {account_id}.
        slots:
          start_date: query.start_date
          end_date: query.end_date
          account_id: path.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/lw/api/accounts/{account_id}/v2/inventory/sp/{spId}/detail'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one Savings Plan's details
      effect: read
      questions:
      - What are the details of a specific Savings Plan?
      - Can I drill into one Savings Plan by its id?
      instructions:
      - text: Get details of Savings Plan {sp_id} in account {account_id}.
        slots:
          sp_id: path.spId
          account_id: path.account_id
      - text: Show Savings Plan {sp_id} using routing id {routing_id}.
        slots:
          sp_id: path.spId
          routing_id: query.routingId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/gateway/lw/api/accounts/{account_id}/v2/filters/sp'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Savings Plan filter options
      effect: read
      questions:
      - What filter values exist for Savings Plans, like instance families or payment options?
      - Which account IDs can I filter Savings Plans by?
      instructions:
      - text: Get Savings Plan filter options for account {account_id}.
        slots:
          account_id: path.account_id
      - text: Show available Savings Plan filters with routing id {routing_id}.
        slots:
          routing_id: query.routingId
      method: generated
      generated: '2026-09-26'