# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Administration Features API
  version: 1.0.0
extends: openapi/conga-features-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 7
- target: $.paths['/features/{parentId}/product-feature-values'].get
  update:
    x-apievangelist-phrasing:
      intent: List product feature values
      effect: read
      questions:
      - What values do products have for a given feature?
      - Can I filter the product values stored on a feature?
      instructions:
      - text: List product feature values for feature {feature}.
        slots:
          feature: path.parentId
      - text: Show values for feature {feature} matching {filter}.
        slots:
          feature: path.parentId
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/features/{parentId}/product-feature-values'].post
  update:
    x-apievangelist-phrasing:
      intent: Create product feature values
      effect: write
      questions:
      - How do I set feature values on products?
      - Can I add several product values for one feature at once?
      instructions:
      - text: Create product feature values for feature {feature}.
        slots:
          feature: path.parentId
      - text: Add new product values to feature {feature}.
        slots:
          feature: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/features/{parentId}/product-feature-values'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete product feature values in bulk
      effect: destructive
      questions:
      - Can I remove many product values from a feature at once?
      - How do I bulk-delete feature values?
      instructions:
      - text: Bulk delete product feature values of feature {feature}.
        slots:
          feature: path.parentId
      - text: Remove the selected product values from feature {feature}.
        slots:
          feature: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/features/{parentId}/product-feature-values'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update product feature values in bulk
      effect: write
      questions:
      - Can I edit multiple product feature values in one call?
      - How do I bulk-update the values of a feature?
      instructions:
      - text: Bulk update product feature values of feature {feature}.
        slots:
          feature: path.parentId
      - text: Edit the selected product values on feature {feature}.
        slots:
          feature: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/features/{parentId}/product-feature-values/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a product feature value
      effect: read
      questions:
      - Where can I see one product's value for a feature?
      - What does a single product feature value record contain?
      instructions:
      - text: Get product feature value {id} of feature {feature}.
        slots:
          id: path.id
          feature: path.parentId
      - text: Show value record {id} under feature {feature}.
        slots:
          id: path.id
          feature: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/features/{parentId}/product-feature-values/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a product feature value
      effect: destructive
      questions:
      - Can I delete one product's value for a feature?
      - How do I remove a single feature value?
      instructions:
      - text: Delete product feature value {id} of feature {feature}.
        slots:
          id: path.id
          feature: path.parentId
      - text: Remove only value {id} from feature {feature}.
        slots:
          id: path.id
          feature: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/features/{parentId}/product-feature-values/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a product feature value
      effect: write
      questions:
      - How do I change one product's value for a feature?
      - Can I edit a single feature value record?
      instructions:
      - text: Update product feature value {id} of feature {feature}.
        slots:
          id: path.id
          feature: path.parentId
      - text: Edit only value {id} under feature {feature}.
        slots:
          id: path.id
          feature: path.parentId
      method: generated
      generated: '2026-10-01'