# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Administration Feature Sets API
  version: 1.0.0
extends: openapi/conga-feature-sets-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: 14
- target: $.paths['/feature-sets'].get
  update:
    x-apievangelist-phrasing:
      intent: List feature sets
      effect: read
      questions:
      - What feature sets exist in my catalog?
      - Can I filter or page through feature sets?
      instructions:
      - text: List all feature sets.
      - text: List feature sets matching {filter}.
        slots:
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create feature sets
      effect: write
      questions:
      - How do I create new feature sets?
      - Can I create multiple feature sets in one request?
      instructions:
      - text: Create new feature sets.
      - text: Add a batch of feature sets.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete feature sets in bulk
      effect: destructive
      questions:
      - Can I delete several feature sets at once?
      - How do I bulk-remove feature sets?
      instructions:
      - text: Bulk delete the selected feature sets.
      - text: Remove multiple feature sets in one call.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update feature sets in bulk
      effect: write
      questions:
      - Can I update many feature sets in one call?
      - How do I bulk-edit feature sets?
      instructions:
      - text: Bulk update the selected feature sets.
      - text: Edit several feature sets at once.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets/{Id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a feature set
      effect: read
      questions:
      - Where can I see one feature set's details?
      - Can I include related records when fetching a feature set?
      instructions:
      - text: Get feature set {id}.
        slots:
          id: path.Id
      - text: Show feature set {id} including {includes}.
        slots:
          id: path.Id
          includes: query.includes
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets/{Id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a feature set
      effect: destructive
      questions:
      - Can I delete a single feature set?
      - What happens when one feature set is removed?
      instructions:
      - text: Delete feature set {id}.
        slots:
          id: path.Id
      - text: Remove only the feature set {id}.
        slots:
          id: path.Id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets/{Id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a feature set
      effect: write
      questions:
      - How do I edit one feature set?
      - Can I change a single feature set's settings?
      instructions:
      - text: Update feature set {id}.
        slots:
          id: path.Id
      - text: Edit only the feature set {id}.
        slots:
          id: path.Id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets/{parentId}/product-features'].get
  update:
    x-apievangelist-phrasing:
      intent: List product features of a feature set
      effect: read
      questions:
      - Which products are linked to a feature set?
      - Can I filter product feature links under one set?
      instructions:
      - text: List product features of feature set {set}.
        slots:
          set: path.parentId
      - text: Show product-feature links in set {set} matching {filter}.
        slots:
          set: path.parentId
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets/{parentId}/product-features'].post
  update:
    x-apievangelist-phrasing:
      intent: Create product features in a feature set
      effect: write
      questions:
      - How do I link products to a feature set?
      - Can I add several product features under one set?
      instructions:
      - text: Create product features in feature set {set}.
        slots:
          set: path.parentId
      - text: Link products to feature set {set}.
        slots:
          set: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets/{parentId}/product-features'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete product features in bulk
      effect: destructive
      questions:
      - Can I unlink many products from a feature set at once?
      - How do I bulk-remove product features from a set?
      instructions:
      - text: Bulk delete product features from feature set {set}.
        slots:
          set: path.parentId
      - text: Unlink the selected products from set {set}.
        slots:
          set: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets/{parentId}/product-features'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update product features in bulk
      effect: write
      questions:
      - Can I edit multiple product features of a set in one call?
      - How do I bulk-update product feature links?
      instructions:
      - text: Bulk update product features in feature set {set}.
        slots:
          set: path.parentId
      - text: Edit the product-feature links under set {set}.
        slots:
          set: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets/{parentId}/product-features/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a product feature
      effect: read
      questions:
      - Where do I see one product feature link?
      - What does a single product feature record hold?
      instructions:
      - text: Get product feature {id} in feature set {set}.
        slots:
          id: path.id
          set: path.parentId
      - text: Show product-feature link {id} of set {set}.
        slots:
          id: path.id
          set: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets/{parentId}/product-features/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a product feature
      effect: destructive
      questions:
      - Can I remove a single product from a feature set?
      - How do I delete one product feature link?
      instructions:
      - text: Delete product feature {id} from feature set {set}.
        slots:
          id: path.id
          set: path.parentId
      - text: Unlink only product feature {id} in set {set}.
        slots:
          id: path.id
          set: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets/{parentId}/product-features/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a product feature
      effect: write
      questions:
      - How do I edit one product feature link?
      - Can I change a single product's feature set entry?
      instructions:
      - text: Update product feature {id} in feature set {set}.
        slots:
          id: path.id
          set: path.parentId
      - text: Edit only product-feature link {id} of set {set}.
        slots:
          id: path.id
          set: path.parentId
      method: generated
      generated: '2026-10-01'