# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Platform REST Product Custom Fields API
  version: 1.0.0
extends: openapi/vendasta-product-custom-fields-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: 3
- target: $.paths['/productCustomFields/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a product's custom fields
      effect: read
      questions:
      - Can I read the custom fields attached to a product?
      - Where are product custom field values configured?
      instructions:
      - text: Get custom fields for product {id}.
        slots:
          id: path.id
      - text: Show the custom field values set on product {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/productCustomFields/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a product's custom fields
      effect: write
      questions:
      - How do I change custom field values on a product?
      - Can I attach extra information to a product through custom fields?
      instructions:
      - text: Update product {id}'s custom fields with {data}.
        slots:
          id: path.id
          data: requestBody.data
      - text: Set custom field values {data} on product {id}.
        slots:
          data: requestBody.data
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/productCustomFields/{id}'].options
  update:
    x-apievangelist-phrasing:
      intent: Check allowed methods on product custom fields
      effect: read
      questions:
      - Which HTTP verbs are allowed on a product's custom fields endpoint?
      - What does a CORS preflight on product custom fields return?
      instructions:
      - text: Run a CORS preflight against product custom fields {id}.
        slots:
          id: path.id
      - text: Show allowed methods for product {id}'s custom fields endpoint.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'