# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Dynatrace Account Management Account Settings API
  version: 1.0.0
extends: openapi/dynatrace-account-settings-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: 8
- target: $.paths['/v1/accounts/{account-uuid}/settings/costcenters'].get
  update:
    x-apievangelist-phrasing:
      intent: List allowed cost center values
      effect: read
      questions:
      - Which cost center values can I allocate Dynatrace spend to?
      - Can I page through the cost center list if there are many?
      instructions:
      - text: List the cost center values configured for account {account}.
        slots:
          account: path.account-uuid
      - text: Show page {page} of cost centers for account {account}.
        slots:
          page: query.page
          account: path.account-uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/accounts/{account-uuid}/settings/costcenters'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace the full set of cost center values
      effect: write
      questions:
      - How do I overwrite all my cost centers with a new list at once?
      - Does replacing cost centers wipe the ones I already have?
      instructions:
      - text: Replace every cost center on account {account} with {values}.
        slots:
          account: path.account-uuid
          values: requestBody.values
      - text: Reset the cost center list for {account} to exactly {values}.
        slots:
          account: path.account-uuid
          values: requestBody.values
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/accounts/{account-uuid}/settings/costcenters'].post
  update:
    x-apievangelist-phrasing:
      intent: Add new cost center values
      effect: write
      questions:
      - Can I add a few new cost centers without touching the existing ones?
      - What's the way to register an additional cost center for chargeback?
      instructions:
      - text: Add cost centers {values} to account {account}.
        slots:
          values: requestBody.values
          account: path.account-uuid
      - text: Append {values} to the cost center options on {account}.
        slots:
          values: requestBody.values
          account: path.account-uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/accounts/{account-uuid}/settings/costcenters/{key}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one cost center value
      effect: destructive
      questions:
      - How do I remove a single cost center that we no longer use?
      - Can I delete one cost center by its key?
      instructions:
      - text: Delete cost center {key} from account {account}.
        slots:
          key: path.key
          account: path.account-uuid
      - text: Remove the retired cost center {key} on {account}.
        slots:
          key: path.key
          account: path.account-uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/accounts/{account-uuid}/settings/products'].get
  update:
    x-apievangelist-phrasing:
      intent: List allowed product allocation values
      effect: read
      questions:
      - Which product values are set up for cost allocation on my account?
      - Can I paginate the product allocation values list?
      instructions:
      - text: List the product allocation values for account {account}.
        slots:
          account: path.account-uuid
      - text: Show {size} product values per page for account {account}.
        slots:
          size: query.page-size
          account: path.account-uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/accounts/{account-uuid}/settings/products'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace the full set of product values
      effect: write
      questions:
      - How do I overwrite the product allocation list with a fresh set?
      - Will replacing product values remove the products currently defined?
      instructions:
      - text: Replace all product allocation values on {account} with {values}.
        slots:
          account: path.account-uuid
          values: requestBody.values
      - text: Set the product list for account {account} to exactly {values}.
        slots:
          account: path.account-uuid
          values: requestBody.values
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/accounts/{account-uuid}/settings/products'].post
  update:
    x-apievangelist-phrasing:
      intent: Add new product allocation values
      effect: write
      questions:
      - Can I add another product for cost allocation while keeping the current ones?
      - What's the call to register new product names for chargeback?
      instructions:
      - text: Add products {values} to the allocation values on {account}.
        slots:
          values: requestBody.values
          account: path.account-uuid
      - text: Append product values {values} for account {account}.
        slots:
          values: requestBody.values
          account: path.account-uuid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/accounts/{account-uuid}/settings/products/{key}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one product allocation value
      effect: destructive
      questions:
      - How do I remove a product we stopped allocating costs to?
      - Can one product value be deleted by key?
      instructions:
      - text: Delete product value {key} from account {account}.
        slots:
          key: path.key
          account: path.account-uuid
      - text: Remove the product allocation entry {key} on {account}.
        slots:
          key: path.key
          account: path.account-uuid
      method: generated
      generated: '2026-09-26'