API Evangelist conversational phrasing for scheduling/tasks Task Graph API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for scheduling/tasks Task Graph API
  version: 1.0.0
extends: openapi/qliksense-task-graph-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/api/scheduling/tasks/{id}/graphs/ancestors'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a task's upstream ancestor graph
      effect: read
      questions:
      - Which upstream tasks must run before a given scheduled task, several levels up?
      - Can I limit how many levels of ancestors the graph traverses?
      instructions:
      - text: Show the ancestor graph for task {id}.
        slots:
          id: path.id
      - text: Get task {id}'s ancestors up to {level} levels.
        slots:
          id: path.id
          level: query.level
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/scheduling/tasks/{id}/graphs/children'].get
  update:
    x-apievangelist-phrasing:
      intent: List a task's direct child tasks
      effect: read
      questions:
      - Which tasks are triggered directly when a given task succeeds?
      - Can I page through the immediate children of a task?
      instructions:
      - text: List the direct child tasks of {id}.
        slots:
          id: path.id
      - text: Show the first {limit} tasks triggered directly by task {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/scheduling/tasks/{id}/graphs/descendants'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a task's downstream descendant graph
      effect: read
      questions:
      - What is the full chain of downstream tasks a task will eventually trigger?
      - Can I see descendants several levels deep, not just direct children?
      instructions:
      - text: Show the descendant graph for task {id}.
        slots:
          id: path.id
      - text: Get task {id}'s downstream descendants to depth {level}.
        slots:
          id: path.id
          level: query.level
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/scheduling/tasks/{id}/graphs/parents'].get
  update:
    x-apievangelist-phrasing:
      intent: List a task's direct parent tasks
      effect: read
      questions:
      - Which tasks directly trigger a given task when they complete?
      - Can I filter or sort the immediate parents of a task?
      instructions:
      - text: List the direct parent tasks of {id}.
        slots:
          id: path.id
      - text: Show the immediate parents of task {id} sorted by {sort}.
        slots:
          id: path.id
          sort: query.sort
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/scheduling/tasks/{id}/graphs/subgraph'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a task's full dependency subgraph
      effect: read
      questions:
      - Can I see both upstream and downstream dependencies of a task in one graph?
      - What does the combined dependency view around a task look like?
      instructions:
      - text: Show the full dependency subgraph around task {id}.
        slots:
          id: path.id
      - text: Get the combined ancestor and descendant graph for {id} to {level} levels.
        slots:
          id: path.id
          level: query.level
      method: generated
      generated: '2026-09-26'