# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for glossaries Links API
  version: 1.0.0
extends: openapi/qliksense-links-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['/api/v1/glossaries/{id}/terms/{termId}/links'].get
  update:
    x-apievangelist-phrasing:
      intent: List resources linked to a glossary term
      effect: read
      questions:
      - Which apps or datasets are linked to a business glossary term?
      - Can I filter the links attached to a term?
      instructions:
      - text: List links on term {termId} in glossary {id}.
        slots:
          termId: path.termId
          id: path.id
      - text: Show resources linked to term {termId} of glossary {id} matching {filter}.
        slots:
          termId: path.termId
          id: path.id
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/glossaries/{id}/terms/{termId}/links'].post
  update:
    x-apievangelist-phrasing:
      intent: Link a resource to a glossary term
      effect: write
      questions:
      - Can I link an app or dataset to a business term?
      - Can I link a term even if it has not been verified?
      instructions:
      - text: Link {resourceType} {resourceId} to term {termId} in glossary {id}.
        slots:
          resourceType: requestBody.resourceType
          resourceId: requestBody.resourceId
          termId: path.termId
          id: path.id
      - text: Attach resource {resourceId} of type {resourceType} to glossary {id} term {termId}.
        slots:
          resourceId: requestBody.resourceId
          resourceType: requestBody.resourceType
          id: path.id
          termId: path.termId
      method: generated
      generated: '2026-10-01'