# 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 Glossary Terms API
  version: 1.0.0
extends: openapi/vendasta-glossary-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: 3
- target: $.paths['/terms'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up glossary term definitions
      effect: read
      questions:
      - What does the term customer mean across different platform contexts?
      - Can I list every glossary term used within the CRM context?
      instructions:
      - text: List glossary terms named {name}.
        slots:
          name: query.filter[name]
      - text: Show all terms defined in the {context} context.
        slots:
          context: query.filter[context.ID]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/terms/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one glossary term
      effect: read
      questions:
      - What is the definition behind a specific glossary term ID?
      - Can I fetch a single term when I already have its identifier?
      instructions:
      - text: Get glossary term {id}.
        slots:
          id: path.id
      - text: Show me the definition of term {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contexts/{id}/terms'].get
  update:
    x-apievangelist-phrasing:
      intent: List the terms within one context
      effect: read
      questions:
      - Which terms belong to a particular glossary context?
      - Can I browse a context's vocabulary starting from the context itself?
      instructions:
      - text: List the terms in glossary context {id}.
        slots:
          id: path.id
      - text: Show every term that context {id} uses.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'