# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Qliksense Request API
  version: 1.0.0
extends: openapi/qliksense-request-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: 8
- target: $.paths['/api/analytics/odag-links/{linkId}/requests'].get
  update:
    x-apievangelist-phrasing:
      intent: List on-demand app requests for an ODAG link
      effect: read
      questions:
      - Which on-demand app generation requests have been made through one ODAG link?
      - Can I see only the pending ODAG requests from a particular selection app sheet?
      instructions:
      - text: List the requests made through ODAG link {linkId}.
        slots:
          linkId: path.linkId
      - text: Show pending requests for ODAG link {linkId} from selection app {selectionAppId}, pending set to {pending}.
        slots:
          linkId: path.linkId
          selectionAppId: query.selectionAppId
          pending: query.pending
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/analytics/odag-links/{linkId}/requests'].post
  update:
    x-apievangelist-phrasing:
      intent: Request a new on-demand app from an ODAG link
      effect: write
      questions:
      - How do I generate an on-demand app from my current selections in a selection app?
      - What happens after I submit an ODAG request, and how do I know it finished?
      instructions:
      - text: Submit an ODAG request on link {linkId} from selection app {selectionApp} with bind selections {bindSelectionState}.
        slots:
          linkId: path.linkId
          selectionApp: requestBody.selectionApp
          bindSelectionState: requestBody.bindSelectionState
      - text: Generate an on-demand app via link {linkId} from app {selectionApp} sheet {sheetname}, binding {bindSelectionState}.
        slots:
          linkId: path.linkId
          selectionApp: requestBody.selectionApp
          sheetname: requestBody.sheetname
          bindSelectionState: requestBody.bindSelectionState
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/analytics/odag-requests/{requestId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the status of an ODAG request
      effect: read
      questions:
      - Is my on-demand app request still queued, loading, succeeded or failed?
      - Which generated app ID did an ODAG request produce?
      instructions:
      - text: Get the status of ODAG request {requestId}.
        slots:
          requestId: path.requestId
      - text: Tell me whether on-demand request {requestId} has finished and which app it generated.
        slots:
          requestId: path.requestId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/analytics/odag-requests/{requestId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Pause, resume or cancel an ODAG request
      effect: destructive
      questions:
      - Can I cancel an on-demand app request once its data has started loading?
      - How do I pause a queued ODAG request and resume it later?
      instructions:
      - text: Apply action {action} to ODAG request {requestId}.
        slots:
          action: query.action
          requestId: path.requestId
      - text: 'Cancel ODAG request {requestId} with action {action} and delete its generated app: {delGenApp}.'
        slots:
          requestId: path.requestId
          action: query.action
          delGenApp: query.delGenApp
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/analytics/odag-requests/{requestId}/app'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an app generated by an ODAG request
      effect: destructive
      questions:
      - Who is allowed to delete an app that an on-demand request generated?
      - How do I remove the generated app from a completed ODAG request?
      instructions:
      - text: Delete the app generated by ODAG request {requestId}.
        slots:
          requestId: path.requestId
      - text: Remove the on-demand app that ODAG request {requestId} created.
        slots:
          requestId: path.requestId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/analytics/odag-requests/{requestId}/reload-app'].post
  update:
    x-apievangelist-phrasing:
      intent: Reload data in an ODAG-generated app
      effect: write
      questions:
      - Can I refresh the data in an on-demand generated app from its sources?
      - Is it possible to copy the request when reloading a generated app?
      instructions:
      - text: Reload the generated app for ODAG request {requestId}.
        slots:
          requestId: path.requestId
      - text: Reload the app from request {requestId} with copy request set to {copyRequest}.
        slots:
          requestId: path.requestId
          copyRequest: requestBody.copyRequest
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/analytics/odag-requests/{requestId}/rename-app'].post
  update:
    x-apievangelist-phrasing:
      intent: Rename an ODAG-generated app
      effect: write
      questions:
      - How do I give an on-demand generated app a better name?
      - Can only the request owner rename an ODAG generated app?
      instructions:
      - text: Rename the app generated by request {requestId} to {appName}.
        slots:
          requestId: path.requestId
          appName: requestBody.appName
      - text: Change the generated app name for ODAG request {requestId} to {appName}.
        slots:
          requestId: path.requestId
          appName: requestBody.appName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/analytics/odag-requests/{requestId}/selections'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the selections behind an ODAG request
      effect: read
      questions:
      - Which field values were selected when an on-demand app request was submitted?
      - Can I see the selection state an ODAG request was made with?
      instructions:
      - text: Show the selections captured with ODAG request {requestId}.
        slots:
          requestId: path.requestId
      - text: List the field values selected when ODAG request {requestId} was submitted.
        slots:
          requestId: path.requestId
      method: generated
      generated: '2026-09-26'