# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Conga Products API
  version: 1.0.0
extends: openapi/conga-products-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: 56
- target: $.paths['/products'].get
  update:
    x-apievangelist-phrasing:
      intent: List products in the catalog
      effect: read
      questions:
      - What products are in my Conga product catalog?
      - Can I filter and sort the full product list, page by page?
      instructions:
      - text: List every product in the catalog.
      - text: List catalog products matching {filter}, sorted by {sort}.
        slots:
          filter: query.filter
          sort: query.sort
      - text: Show page {page} of the product collection, {limit} products per page.
        slots:
          page: query.page
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products'].post
  update:
    x-apievangelist-phrasing:
      intent: Create several products at once
      effect: write
      questions:
      - Can I add a batch of new products to the catalog in one request?
      - Is there a bulk way to load many new products instead of one at a time?
      instructions:
      - text: Create these new products in the catalog in bulk.
      - text: Add several new products to the product catalog in one call.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete several products in bulk
      effect: destructive
      questions:
      - Can I remove a whole batch of products from the catalog at once?
      - Is there a bulk delete for products I no longer sell?
      instructions:
      - text: Delete these products from the catalog in one bulk request.
      - text: Remove several retired products from the catalog at once.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update several products in bulk
      effect: write
      questions:
      - Can I edit fields on many products in a single request?
      - Is there a bulk update for changing a batch of catalog products?
      instructions:
      - text: Apply these field changes to several products in bulk.
      - text: Update a batch of catalog products at once.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{Id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a product record by ID
      effect: read
      questions:
      - How can I look up a single product record by its ID?
      - Can I pull one product record with its related objects included?
      instructions:
      - text: Get the product record with ID {Id}.
        slots:
          Id: path.Id
      - text: Fetch product record {Id} including {includes}.
        slots:
          Id: path.Id
          includes: query.includes
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{Id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one product
      effect: destructive
      questions:
      - Can I delete just one product from the catalog by its ID?
      - What happens when I remove a single product record?
      instructions:
      - text: Delete product {Id} from the catalog.
        slots:
          Id: path.Id
      - text: Remove the single product record {Id}.
        slots:
          Id: path.Id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{Id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update one product
      effect: write
      questions:
      - How do I change the details of one specific product?
      - Can I edit a single product record without touching the others?
      instructions:
      - text: Update product {Id} with these field changes.
        slots:
          Id: path.Id
      - text: Edit the single product record {Id}.
        slots:
          Id: path.Id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{id}/attribute-matrices'].get
  update:
    x-apievangelist-phrasing:
      intent: List a product's attribute matrices
      effect: read
      questions:
      - Which attribute matrices are attached to a given product?
      - Can I see the attribute value matrices defined for one product?
      instructions:
      - text: List the attribute matrices for product {id}.
        slots:
          id: path.id
      - text: Show product {id}'s attribute matrices.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{id}/attribute-rules'].get
  update:
    x-apievangelist-phrasing:
      intent: List a product's attribute rules
      effect: read
      questions:
      - What attribute rules apply to a particular product?
      - Can I page through the attribute rules defined on one product?
      instructions:
      - text: List the attribute rules for product {id}.
        slots:
          id: path.id
      - text: Show page {page} of product {id}'s attribute rules.
        slots:
          id: path.id
          page: query.page
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{id}/categories'].get
  update:
    x-apievangelist-phrasing:
      intent: List the categories a product belongs to
      effect: read
      questions:
      - Which catalog categories is a product listed under?
      - Can I look up the category lookup records for one product?
      instructions:
      - text: Show which categories product {id} belongs to.
        slots:
          id: path.id
      - text: List up to {limit} category lookup records for product {id}.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{id}/clone'].post
  update:
    x-apievangelist-phrasing:
      intent: Clone a product
      effect: write
      questions:
      - Can I copy an existing product to start a new one?
      - Is it possible to deep clone a product while excluding some related objects?
      instructions:
      - text: Clone product {id}.
        slots:
          id: path.id
      - text: Deep clone product {id} but leave out {excludeObjects}.
        slots:
          id: path.id
          excludeObjects: query.excludeObjects
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{id}/constraint-rules'].get
  update:
    x-apievangelist-phrasing:
      intent: List a product's constraint rules
      effect: read
      questions:
      - What constraint rules are tied to a specific product?
      - Can I see the inclusion and exclusion constraint rules for one product?
      instructions:
      - text: List the constraint rules for product {id}.
        slots:
          id: path.id
      - text: Show the constraint rule details on product {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{id}/price-lists'].get
  update:
    x-apievangelist-phrasing:
      intent: List the price lists that carry a product
      effect: read
      questions:
      - Which price lists is a given product included in?
      - Can I find every price list that a product is sold on?
      instructions:
      - text: List the price lists that include product {id}.
        slots:
          id: path.id
      - text: Show page {page} of price lists for product {id}.
        slots:
          id: path.id
          page: query.page
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{id}/product-groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List the product groups a product is in
      effect: read
      questions:
      - What product groups does a specific product belong to?
      - Can I see the groups one product has been placed in?
      instructions:
      - text: List the product groups for product {id}.
        slots:
          id: path.id
      - text: Show up to {limit} product groups that product {id} is in.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/price-list-items'].get
  update:
    x-apievangelist-phrasing:
      intent: List a product's price list items
      effect: read
      questions:
      - What price list items exist for a product, with their prices?
      - Can I filter a product's price list items by a field?
      instructions:
      - text: List the price list items for product {parentId}.
        slots:
          parentId: path.parentId
      - text: Show price list items for product {parentId} matching {filter}.
        slots:
          parentId: path.parentId
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/price-list-items'].post
  update:
    x-apievangelist-phrasing:
      intent: Create price list items for a product
      effect: write
      questions:
      - How many price list items can I create in one request?
      - Can I add several new price entries for a product at once?
      instructions:
      - text: Create these price list items for product {parentId}.
        slots:
          parentId: path.parentId
      - text: Add a batch of new price list items under product {parentId}.
        slots:
          parentId: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/price-list-items'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete several price list items of a product
      effect: destructive
      questions:
      - Can I remove multiple price list items from a product in one go?
      - Is there a bulk delete for a product's price list entries?
      instructions:
      - text: Delete these price list items from product {parentId} in bulk.
        slots:
          parentId: path.parentId
      - text: Remove several price list items under product {parentId} at once.
        slots:
          parentId: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/price-list-items'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update several price list items of a product
      effect: write
      questions:
      - Can I change list prices on many of a product's price list items together?
      - Which price list item fields can't be changed in a bulk update?
      instructions:
      - text: Update these price list items for product {parentId} in bulk.
        slots:
          parentId: path.parentId
      - text: Apply field changes to multiple price list items under product {parentId}.
        slots:
          parentId: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/price-list-items/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve one price list item of a product
      effect: read
      questions:
      - Can I look up a single price list item and its details?
      - Where do I see the pricing on one specific price list entry?
      instructions:
      - text: Get price list item {id} of product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      - text: Show the details of price list entry {id} under product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/price-list-items/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one price list item
      effect: destructive
      questions:
      - Can I delete a single price list item from a product?
      - Does deleting one price list item return a delete status?
      instructions:
      - text: Delete price list item {id} from product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      - text: Remove the single price list entry {id} under product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/price-list-items/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update one price list item
      effect: write
      questions:
      - How can I change the price on one specific price list item?
      - Can I edit a single price list entry without touching the rest?
      instructions:
      - text: Update price list item {id} of product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      - text: Change the fields on the single price list entry {id} for product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/price-list-items/{id}/clone'].post
  update:
    x-apievangelist-phrasing:
      intent: Clone a price list item
      effect: write
      questions:
      - Can I duplicate an existing price list item?
      - Is a deep clone of a price list entry possible?
      instructions:
      - text: Clone price list item {id} of product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      - text: Deep clone price list entry {id} under product {parentId}, excluding {excludeObjects}.
        slots:
          parentId: path.parentId
          id: path.id
          excludeObjects: query.excludeObjects
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-categories'].get
  update:
    x-apievangelist-phrasing:
      intent: List a product's product-category records
      effect: read
      questions:
      - Which product-category assignment records exist for a product?
      - Can I filter and sort a product's product-category links?
      instructions:
      - text: List the product-category records for product {parentId}.
        slots:
          parentId: path.parentId
      - text: Show product-category records for product {parentId} sorted by {sort}.
        slots:
          parentId: path.parentId
          sort: query.sort
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-categories'].post
  update:
    x-apievangelist-phrasing:
      intent: Assign a product to categories
      effect: write
      questions:
      - How do I put a product into several catalog categories at once?
      - Can I create multiple product-category records for one product?
      instructions:
      - text: Create these product-category records for product {parentId}.
        slots:
          parentId: path.parentId
      - text: Add product {parentId} to several catalog categories.
        slots:
          parentId: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-categories'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a product from several categories
      effect: destructive
      questions:
      - Can I take a product out of multiple categories in one request?
      - Is there a bulk delete for a product's category assignments?
      instructions:
      - text: Delete these product-category records from product {parentId}.
        slots:
          parentId: path.parentId
      - text: Remove product {parentId} from several categories at once.
        slots:
          parentId: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-categories'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update several product-category records
      effect: write
      questions:
      - Can I edit multiple category assignments of a product together?
      - Is there a bulk update for a product's product-category records?
      instructions:
      - text: Update these product-category records for product {parentId} in bulk.
        slots:
          parentId: path.parentId
      - text: Apply changes to several category assignments on product {parentId}.
        slots:
          parentId: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-categories/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve one product-category record
      effect: read
      questions:
      - Can I look up a single product-category assignment by its ID?
      - Where do I see the details of one category link on a product?
      instructions:
      - text: Get product-category record {id} for product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      - text: Show category assignment {id} on product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-categories/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one product-category record
      effect: destructive
      questions:
      - Can I remove a single category assignment from a product?
      - What's the way to delete one product-category link by ID?
      instructions:
      - text: Delete product-category record {id} from product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      - text: Remove the single category assignment {id} on product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-categories/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update one product-category record
      effect: write
      questions:
      - Can I edit a single category assignment on a product?
      - How would I change one product-category record by its ID?
      instructions:
      - text: Update product-category record {id} on product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      - text: Edit the single category assignment {id} for product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-feature-values'].get
  update:
    x-apievangelist-phrasing:
      intent: List a product's feature values
      effect: read
      questions:
      - What feature values have been set on a product?
      - Can I filter the feature value records linked to one product?
      instructions:
      - text: List the feature values set on product {parentId}.
        slots:
          parentId: path.parentId
      - text: Show feature values for product {parentId} matching {filter}.
        slots:
          parentId: path.parentId
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-feature-values'].post
  update:
    x-apievangelist-phrasing:
      intent: Add feature values to a product
      effect: write
      questions:
      - How do I record values for a product's features?
      - Can I create several feature value records for a product together?
      instructions:
      - text: Create these feature values on product {parentId}.
        slots:
          parentId: path.parentId
      - text: Add a batch of feature value records to product {parentId}.
        slots:
          parentId: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-feature-values'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete several feature values of a product
      effect: destructive
      questions:
      - Can I clear multiple feature values from a product at once?
      - Is there a bulk delete for a product's feature value records?
      instructions:
      - text: Delete these feature values from product {parentId} in bulk.
        slots:
          parentId: path.parentId
      - text: Remove several feature value records on product {parentId} at once.
        slots:
          parentId: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-feature-values'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update several feature values of a product
      effect: write
      questions:
      - Can I change many of a product's feature values in one request?
      - Is there a bulk edit for product feature value records?
      instructions:
      - text: Update these feature values on product {parentId} in bulk.
        slots:
          parentId: path.parentId
      - text: Change several feature value records for product {parentId} at once.
        slots:
          parentId: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-feature-values/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve one product feature value
      effect: read
      questions:
      - Can I look up one specific feature value on a product?
      - Where do I find a single feature value record by its ID?
      instructions:
      - text: Get feature value {id} on product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      - text: Show the single feature value record {id} for product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-feature-values/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unlink one feature value from a product
      effect: destructive
      questions:
      - If I delete a product's feature value, are the product and feature kept?
      - Can I remove one feature value link from a product by ID?
      instructions:
      - text: Delete feature value {id} from product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      - text: Unlink the single feature value record {id} on product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-feature-values/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update one product feature value
      effect: write
      questions:
      - Can I change a single feature value on a product?
      - How would I edit one feature value record by its ID?
      instructions:
      - text: Update feature value {id} on product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      - text: Edit the single feature value record {id} for product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-features'].get
  update:
    x-apievangelist-phrasing:
      intent: List the features linked to a product
      effect: read
      questions:
      - Which features are linked to a specific product?
      - Can I sort and page through a product's feature links?
      instructions:
      - text: List the features linked to product {parentId}.
        slots:
          parentId: path.parentId
      - text: Show product {parentId}'s feature links sorted by {sort}.
        slots:
          parentId: path.parentId
          sort: query.sort
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-features'].post
  update:
    x-apievangelist-phrasing:
      intent: Link features to a product
      effect: write
      questions:
      - How do I attach several features to a product?
      - Can I create multiple product-feature links in one request?
      instructions:
      - text: Link these features to product {parentId}.
        slots:
          parentId: path.parentId
      - text: Create a batch of product-feature links on product {parentId}.
        slots:
          parentId: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-features'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unlink several features from a product
      effect: destructive
      questions:
      - Can I detach multiple features from a product at once?
      - Is there a bulk delete for a product's feature links?
      instructions:
      - text: Unlink these features from product {parentId} in bulk.
        slots:
          parentId: path.parentId
      - text: Delete several product-feature links on product {parentId} at once.
        slots:
          parentId: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-features'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update several product-feature links
      effect: write
      questions:
      - Can I edit many of a product's feature links together?
      - Is there a bulk update for product-feature link records?
      instructions:
      - text: Update these product-feature links on product {parentId} in bulk.
        slots:
          parentId: path.parentId
      - text: Change several feature links for product {parentId} at once.
        slots:
          parentId: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-features/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve one product-feature link
      effect: read
      questions:
      - Can I look up a single feature link on a product by its ID?
      - Where do I see one product-feature record's details?
      instructions:
      - text: Get feature link {id} on product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      - text: Show which feature the link {id} attaches to product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-features/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unlink one feature from a product
      effect: destructive
      questions:
      - Can I detach just one feature from a product?
      - How would I delete a single product-feature link by ID?
      instructions:
      - text: Delete feature link {id} from product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      - text: Detach the single product-feature record {id} on product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-features/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update one product-feature link
      effect: write
      questions:
      - Can I edit a single feature link on a product?
      - What's the call to change one product-feature record by ID?
      instructions:
      - text: Update feature link {id} on product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      - text: Modify the feature attachment {id} that ties a feature to product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-group-members'].get
  update:
    x-apievangelist-phrasing:
      intent: List a product's group memberships
      effect: read
      questions:
      - What product group member records exist for a product?
      - Can I filter a product's group membership records?
      instructions:
      - text: List the product group member records for product {parentId}.
        slots:
          parentId: path.parentId
      - text: Show group memberships of product {parentId} matching {filter}.
        slots:
          parentId: path.parentId
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-group-members'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a product to product groups
      effect: write
      questions:
      - How do I make a product a member of one or more product groups?
      - Can I create several group member records for a product at once?
      instructions:
      - text: Create these product group member records for product {parentId}.
        slots:
          parentId: path.parentId
      - text: Add product {parentId} as a member of several product groups.
        slots:
          parentId: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-group-members'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a product from several groups
      effect: destructive
      questions:
      - Can I drop a product from multiple product groups in one request?
      - Is there a bulk delete for a product's group member records?
      instructions:
      - text: Delete these product group member records from product {parentId}.
        slots:
          parentId: path.parentId
      - text: Remove product {parentId} from several product groups at once.
        slots:
          parentId: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-group-members'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update several group memberships of a product
      effect: write
      questions:
      - Can I edit multiple group member records of a product together?
      - Is there a bulk update for a product's group memberships?
      instructions:
      - text: Update these product group member records on product {parentId} in bulk.
        slots:
          parentId: path.parentId
      - text: Change several group memberships of product {parentId} at once.
        slots:
          parentId: path.parentId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-group-members/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve one product group member record
      effect: read
      questions:
      - Can I look up a single group membership of a product by ID?
      - Where do I see the details of one product group member record?
      instructions:
      - text: Get product group member {id} for product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      - text: Show group membership record {id} on product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-group-members/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one product group member record
      effect: destructive
      questions:
      - Can I remove a product from just one product group?
      - What's the way to delete a single group member record by ID?
      instructions:
      - text: Delete product group member {id} from product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      - text: Remove the single group membership {id} on product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{parentId}/product-group-members/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update one product group member record
      effect: write
      questions:
      - Can I edit a single group membership of a product?
      - How would I change one product group member record by ID?
      instructions:
      - text: Update product group member {id} on product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      - text: Edit the single group membership record {id} for product {parentId}.
        slots:
          parentId: path.parentId
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{productId}/attributes'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a product's attributes
      effect: read
      questions:
      - What attributes are defined for a particular product?
      - Can I page through the attribute list of one product?
      instructions:
      - text: Get the attributes of product {productId}.
        slots:
          productId: path.productId
      - text: Show page {page} of product {productId}'s attributes.
        slots:
          productId: path.productId
          page: query.page
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/asset/v1/product/{productId}/replacement-products'].get
  update:
    x-apievangelist-phrasing:
      intent: Find replacement products for an asset product
      effect: read
      questions:
      - Which products can replace an existing asset's product on a given price list?
      - Can I sort the list of replacement products for a product?
      instructions:
      - text: List replacement products for product {productId} on price list {priceListId}.
        slots:
          productId: path.productId
          priceListId: query.priceListId
      - text: Show replacements for product {productId} in price list {priceListId}, sorted by {sortField}.
        slots:
          productId: path.productId
          priceListId: query.priceListId
          sortField: query.sortField
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/compare'].post
  update:
    x-apievangelist-phrasing:
      intent: Compare product attributes side by side
      effect: read
      questions:
      - Can I compare the attributes of several products side by side?
      - Is there a way to see how a few products differ in their attributes?
      instructions:
      - text: Compare the attributes of these products.
      - text: Compare these products' attributes using price list {pricelistId}.
        slots:
          pricelistId: header.pricelistId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/details'].post
  update:
    x-apievangelist-phrasing:
      intent: Get catalog details for several products
      effect: read
      questions:
      - Can I fetch catalog details for a list of product IDs in one request?
      - Is there a batch lookup of product details against a price list?
      instructions:
      - text: Get catalog details for this list of product IDs.
      - text: Fetch details for these products on price list {pricelistid}.
        slots:
          pricelistid: header.pricelistid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{productId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a sellable product's catalog details
      effect: read
      questions:
      - How do I see a product's list price, charge type and bundle options?
      - Which products show up in a catalog detail lookup, only active ones?
      instructions:
      - text: Show catalog details, pricing and options for product {productId}.
        slots:
          productId: path.productId
      - text: Get product {productId}'s catalog details on price list {pricelistid}.
        slots:
          productId: path.productId
          pricelistid: header.pricelistid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/products/{productId}/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search inside a bundle's options and attributes
      effect: read
      questions:
      - Can I search a bundle's option groups and options for some text?
      - Is there a way to find which options inside a bundle match a keyword?
      instructions:
      - text: Search bundle {productId} for options matching {query}.
        slots:
          productId: path.productId
          query: query.query
      - text: Find {query} within the option groups of bundle {productId}.
        slots:
          productId: path.productId
          query: query.query
      method: generated
      generated: '2026-10-01'