# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Cost Categories API
  version: 1.0.0
extends: openapi/harness-cost-categories-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: 6
- target: $.paths['/ccm/api/business-mapping/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a cost category
      effect: read
      questions:
      - What cost buckets and rules make up a particular cost category?
      - Can I view one cost category's shared cost settings?
      instructions:
      - text: Show cost category {id}.
        slots:
          id: path.id
      - text: Get the buckets and rules of cost category {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/business-mapping/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a cost category
      effect: destructive
      questions:
      - How do I delete a cost category?
      - Why would deleting a cost category fail when perspectives use it?
      instructions:
      - text: Delete cost category {id}.
        slots:
          id: path.id
      - text: Remove cost category {id} if no perspectives use it.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/business-mapping/filter-panel'].get
  update:
    x-apievangelist-phrasing:
      intent: Get cost categories for the recommendation filters
      effect: read
      questions:
      - Which cost categories and buckets can I filter recommendations by?
      - Can I search cost buckets for the recommendations filter panel?
      instructions:
      - text: List cost buckets of {costCategory} for the recommendation filter panel.
        slots:
          costCategory: query.costCategory
      - text: Search recommendation filter cost categories for {search}.
        slots:
          search: query.search
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/business-mapping'].get
  update:
    x-apievangelist-phrasing:
      intent: List cost categories
      effect: read
      questions:
      - What cost categories are set up in my account?
      - Can I search cost categories by name?
      instructions:
      - text: List all cost categories.
      - text: Search cost categories for {searchKey}.
        slots:
          searchKey: query.searchKey
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/business-mapping'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a cost category
      effect: write
      questions:
      - How do I change the buckets or rules on an existing cost category?
      - Can I rename a cost category?
      instructions:
      - text: Update cost category {uuid} to name {name} for account {accountId}.
        slots:
          uuid: requestBody.uuid
          name: requestBody.name
          accountId: requestBody.accountId
      - text: Change the cost buckets of cost category {uuid} to {costTargets}, keeping name {name} and account {accountId}.
        slots:
          uuid: requestBody.uuid
          costTargets: requestBody.costTargets
          name: requestBody.name
          accountId: requestBody.accountId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/ccm/api/business-mapping'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a cost category
      effect: write
      questions:
      - How do I allocate cloud costs by team or business unit?
      - Can a new cost category split shared costs across buckets?
      instructions:
      - text: Create cost category {name} for account {accountId}.
        slots:
          name: requestBody.name
          accountId: requestBody.accountId
      - text: Create cost category {name} in account {accountId} with buckets {costTargets} and shared costs {sharedCosts}.
        slots:
          name: requestBody.name
          accountId: requestBody.accountId
          costTargets: requestBody.costTargets
          sharedCosts: requestBody.sharedCosts
      method: generated
      generated: '2026-09-26'