# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Iterable Commerce API
  version: 1.0.0
extends: openapi/iterable-commerce-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: 4
- target: $.paths['/api/commerce/trackPurchase'].post
  update:
    x-apievangelist-phrasing:
      intent: Track a purchase and clear the cart
      effect: write
      questions:
      - Does tracking a purchase clear the user's shopping cart items?
      - Can I attribute a purchase to a campaign and give it my own ID?
      instructions:
      - text: Track a purchase of {items} totaling {total} for user {user}.
        slots:
          items: requestBody.items
          total: requestBody.total
          user: requestBody.user
      - text: Record purchase {id} for {user} with items {items} and total {total}, attributed to campaign {campaignId}.
        slots:
          id: requestBody.id
          user: requestBody.user
          items: requestBody.items
          total: requestBody.total
          campaignId: requestBody.campaignId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/commerce/updateCart'].post
  update:
    x-apievangelist-phrasing:
      intent: Replace a user's shopping cart items
      effect: write
      questions:
      - How do I update shoppingCartItems on a user profile?
      - Will updating a cart create the user if they don't exist yet?
      instructions:
      - text: Set the shopping cart for {user} to {items}.
        slots:
          user: requestBody.user
          items: requestBody.items
      - text: Update {user}'s shoppingCartItems with {items} via /api/commerce.
        slots:
          user: requestBody.user
          items: requestBody.items
      method: generated
      generated: '2026-10-01'
- target: $.paths['/commerce/trackPurchase'].post
  update:
    x-apievangelist-phrasing:
      intent: Track a purchase for revenue attribution
      effect: write
      questions:
      - Can I log a purchase for revenue attribution using the simple /commerce endpoint?
      - What purchase details are recorded for revenue reporting?
      instructions:
      - text: Using /commerce/trackPurchase, log items {items} worth {total} for {user}.
        slots:
          items: requestBody.items
          total: requestBody.total
          user: requestBody.user
      - text: Record a {total} purchase by {user} at {createdAt} with items {items} for revenue attribution.
        slots:
          total: requestBody.total
          user: requestBody.user
          createdAt: requestBody.createdAt
          items: requestBody.items
      method: generated
      generated: '2026-10-01'
- target: $.paths['/commerce/updateCart'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a cart for abandoned-cart campaigns
      effect: write
      questions:
      - How can I feed cart contents into abandoned cart campaigns?
      - Is there a basic /commerce endpoint to update what's in a user's cart?
      instructions:
      - text: Update the cart for {user} to {items} for abandoned-cart messaging.
        slots:
          user: requestBody.user
          items: requestBody.items
      - text: Using /commerce/updateCart, save cart contents {items}.
        slots:
          items: requestBody.items
      method: generated
      generated: '2026-10-01'