# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Cloud and AI cost anomaly details API
  version: 1.0.0
extends: openapi/harness-cloud-and-ai-cost-anomaly-details-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['/ccm/api/anomaly/v2/drill-down/cost/time-series'].get
  update:
    x-apievangelist-phrasing:
      intent: Chart actual cost over time for an anomaly
      effect: read
      questions:
      - What did actual spend look like day by day around a cost anomaly?
      - Can I get the cost time series for an anomaly over a custom window?
      instructions:
      - text: Get the cost time series for anomaly {anomaly}.
        slots:
          anomaly: query.anomalyId
      - text: Show actual cost for anomaly {anomaly} from {start} to {end}.
        slots:
          anomaly: query.anomalyId
          start: query.startTime
          end: query.endTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/anomaly/v2/drill-down'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a cost anomaly
      effect: read
      questions:
      - What caused a specific cloud or AI cost anomaly and how big was it?
      - Can I drill down into one anomaly by its ID?
      instructions:
      - text: Get details for cost anomaly {anomaly}.
        slots:
          anomaly: query.anomalyId
      - text: Drill into anomaly {anomaly} in account {account}.
        slots:
          anomaly: query.anomalyId
          account: query.accountIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/anomaly/v2/drill-down/resource/cost/time-series'].get
  update:
    x-apievangelist-phrasing:
      intent: Chart cost over time for one anomalous resource
      effect: read
      questions:
      - How did one resource's cost trend during an anomaly?
      - Can I see the time series for a single contributing resource?
      instructions:
      - text: Get the cost time series for resource {resource} in anomaly {anomaly}.
        slots:
          resource: query.resource
          anomaly: query.anomalyId
      - text: Chart spend on {resource} for anomaly {anomaly} between {start} and {end}.
        slots:
          resource: query.resource
          anomaly: query.anomalyId
          start: query.startTime
          end: query.endTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/anomaly/v2/drill-down/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List top resources behind a cost anomaly
      effect: read
      questions:
      - Which resources contributed most to this cost anomaly?
      - What are the top cost drivers for an anomaly?
      instructions:
      - text: List the top contributing resources for anomaly {anomaly}.
        slots:
          anomaly: query.anomalyId
      - text: Show which resources drove cost anomaly {anomaly}.
        slots:
          anomaly: query.anomalyId
      method: generated
      generated: '2026-09-26'