# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for analytics/odag-links Link API
  version: 1.0.0
extends: openapi/qliksense-link-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: 6
- target: $.paths['/api/analytics/odag-links'].get
  update:
    x-apievangelist-phrasing:
      intent: List ODAG links
      effect: read
      questions:
      - Which on-demand app generation links exist in my tenant?
      - Can I list only the ODAG links attached to one selection app?
      instructions:
      - text: List all ODAG links.
      - text: List ODAG links for selection app {selectionAppID}.
        slots:
          selectionAppID: query.selectionAppID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/analytics/odag-links'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an ODAG link
      effect: write
      questions:
      - How do I set up on-demand app generation between a selection app and a template app?
      - Can I control the row estimate expression when creating an ODAG link?
      instructions:
      - text: Create ODAG link {name} from selection app {selectionApp} to template {templateApp}.
        slots:
          name: requestBody.name
          selectionApp: requestBody.selectionApp
          templateApp: requestBody.templateApp
      - text: Create ODAG link {name} on selection app {selectionApp}.
        slots:
          name: requestBody.name
          selectionApp: requestBody.selectionApp
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/analytics/odag-links/{linkId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an ODAG link's details
      effect: read
      questions:
      - Where can I review the bindings and status of one ODAG link?
      - Can I see the template app charts for a specific ODAG link?
      instructions:
      - text: Get ODAG link {linkId}.
        slots:
          linkId: path.linkId
      - text: Show ODAG link {linkId} including template charts.
        slots:
          linkId: path.linkId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/analytics/odag-links/{linkId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an ODAG link
      effect: write
      questions:
      - Can I change the template app or bindings on an existing ODAG link?
      - Can I reassign the owner of an ODAG link?
      instructions:
      - text: Update ODAG link {linkId} with name {name} and selection app {selectionApp}.
        slots:
          linkId: path.linkId
          name: requestBody.name
          selectionApp: requestBody.selectionApp
      - text: Point ODAG link {linkId} ({name}, selection app {selectionApp}) at template {templateApp}.
        slots:
          linkId: path.linkId
          name: requestBody.name
          selectionApp: requestBody.selectionApp
          templateApp: requestBody.templateApp
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/analytics/odag-links/cancreate'].get
  update:
    x-apievangelist-phrasing:
      intent: Check permission to create ODAG links
      effect: read
      questions:
      - Am I allowed to create new ODAG links?
      - Can I check create permission for a specific template app before building a link?
      instructions:
      - text: Check whether I can create ODAG links.
      - text: Check if I can create an ODAG link for template app {optTemplateAppId}.
        slots:
          optTemplateAppId: query.optTemplateAppId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/analytics/odag-links/selection-app-link-usages'].post
  update:
    x-apievangelist-phrasing:
      intent: Register ODAG links used by a selection app
      effect: write
      questions:
      - Which ODAG links referenced by a selection app can I actually access?
      - What should run when a selection app is opened so its ODAG link references stay current?
      instructions:
      - text: Sync the ODAG links {linkList} used by selection app {selAppId}.
        slots:
          linkList: requestBody.linkList
          selAppId: query.selAppId
      - text: Register link usages {linkList} for selection app {selAppId} and return the ones I can use.
        slots:
          linkList: requestBody.linkList
          selAppId: query.selAppId
      method: generated
      generated: '2026-09-26'