# 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 API
  version: 1.0.0
extends: openapi/conga-feature-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['/feature-sets/{ParentId}/features'].get
  update:
    x-apievangelist-phrasing:
      intent: List features in a feature set
      effect: read
      questions:
      - Which features belong to a feature set?
      - Can I filter the features under one feature set?
      instructions:
      - text: List the features in feature set {set}.
        slots:
          set: path.ParentId
      - text: Show features in feature set {set} matching {filter}.
        slots:
          set: path.ParentId
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets/{ParentId}/features'].post
  update:
    x-apievangelist-phrasing:
      intent: Add features to a feature set
      effect: write
      questions:
      - How do I add new features to a feature set?
      - Can I create several features under one set at once?
      instructions:
      - text: Create features in feature set {set}.
        slots:
          set: path.ParentId
      - text: Add new features under set {set}.
        slots:
          set: path.ParentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets/{ParentId}/features'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete features from a feature set
      effect: destructive
      questions:
      - Can I remove multiple features from a feature set?
      - How do I bulk-delete features in a set?
      instructions:
      - text: Delete the selected features from feature set {set}.
        slots:
          set: path.ParentId
      - text: Bulk remove features under set {set}.
        slots:
          set: path.ParentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets/{ParentId}/features'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update features in a feature set
      effect: write
      questions:
      - Can I edit several features in a set in one call?
      - How do I bulk-update features in a feature set?
      instructions:
      - text: Update the features in feature set {set}.
        slots:
          set: path.ParentId
      - text: Bulk edit features under set {set}.
        slots:
          set: path.ParentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets/{ParentId}/features/{Id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one feature in a feature set
      effect: read
      questions:
      - Where can I see a single feature's details?
      - What does one feature inside a set look like?
      instructions:
      - text: Get feature {id} in feature set {set}.
        slots:
          id: path.Id
          set: path.ParentId
      - text: Show feature {id} from set {set}.
        slots:
          id: path.Id
          set: path.ParentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets/{ParentId}/features/{Id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one feature from a feature set
      effect: destructive
      questions:
      - Can I delete a single feature from a set?
      - What happens when I remove one feature?
      instructions:
      - text: Delete feature {id} from feature set {set}.
        slots:
          id: path.Id
          set: path.ParentId
      - text: Remove only feature {id} in set {set}.
        slots:
          id: path.Id
          set: path.ParentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/feature-sets/{ParentId}/features/{Id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update one feature in a feature set
      effect: write
      questions:
      - How do I edit a single feature?
      - Can I change just one feature in a set?
      instructions:
      - text: Update feature {id} in feature set {set}.
        slots:
          id: path.Id
          set: path.ParentId
      - text: Edit only feature {id} under set {set}.
        slots:
          id: path.Id
          set: path.ParentId
      method: generated
      generated: '2026-10-01'