# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Data Glossary Context Terms API
  version: 1.0.0
extends: openapi/vendasta-terms-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: 2
- target: $.paths['/terms'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a glossary term
      effect: write
      questions:
      - How do I add a new term to the glossary?
      - Can I attach relationships when creating a glossary term?
      instructions:
      - text: Create a glossary term with attributes {attributes}.
        slots:
          attributes: requestBody.attributes
      - text: Add a term {attributes} related to {relationships}.
        slots:
          attributes: requestBody.attributes
          relationships: requestBody.relationships
      method: generated
      generated: '2026-10-01'
- target: $.paths['/terms/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a glossary term
      effect: write
      questions:
      - Can I change the definition of an existing glossary term?
      - Is it possible to update only some fields of a term?
      instructions:
      - text: Update glossary term {id} with {data}.
        slots:
          id: path.id
          data: requestBody.data
      - text: Edit term {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'