API Evangelist conversational phrasing for Lineage Graphs API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Lineage Graphs API
  version: 1.0.0
extends: openapi/qliksense-lineage-graphs-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/v1/lineage-graphs/nodes/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the lineage graph of a node
      effect: read
      questions:
      - Where does the data in this field or table come from upstream?
      - Can I collapse the lineage graph to the resource level?
      instructions:
      - text: Show the lineage graph for {id}.
        slots:
          id: path.id
      - text: Get the upstream lineage of {id} at level {level}, collapsed {collapse}.
        slots:
          id: path.id
          level: query.level
          collapse: query.collapse
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/lineage-graphs/nodes/{id}/actions/expand'].get
  update:
    x-apievangelist-phrasing:
      intent: Expand a node in a lineage graph
      effect: read
      questions:
      - Can I expand one node of an upstream lineage graph to see its edges?
      - Which edges connect a node I expand in a lineage view?
      instructions:
      - text: Expand lineage node {node} at level {level} for root {id}.
        slots:
          node: query.node
          level: query.level
          id: path.id
      - text: Show the edges of upstream node {node} at {level} in the lineage of {id}.
        slots:
          node: query.node
          level: query.level
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/lineage-graphs/nodes/{id}/actions/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search labels in a lineage graph
      effect: read
      questions:
      - Can I search an upstream lineage graph for a source by name?
      - Are lineage search results returned per level?
      instructions:
      - text: Search the lineage of {id} for labels matching {filter}.
        slots:
          id: path.id
          filter: query.filter
      - text: Find upstream sources named like {filter} in the lineage of {id}.
        slots:
          filter: query.filter
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/lineage-graphs/nodes/{id}/overview'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a direct upstream lineage overview
      effect: read
      questions:
      - Which datasets or apps directly feed each field of a resource?
      - Can I get just the first generation of upstream lineage?
      instructions:
      - text: Give a lineage overview of direct sources for {id}.
        slots:
          id: path.id
      - text: Show first-generation upstream datasets for each field of {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'