# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Qliksense Computation API
  version: 1.0.0
extends: openapi/qliksense-computation-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/data-governance/data-qualities/batch-computations/{batchComputationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a batch data quality computation
      effect: read
      questions:
      - How do I track a batch data quality computation across several datasets?
      - Can I see per-dataset status for a batch computation?
      instructions:
      - text: Show the status of batch computation {batchComputationId}.
        slots:
          batchComputationId: path.batchComputationId
      - text: Show per-dataset progress for batch computation {batchComputationId}.
        slots:
          batchComputationId: path.batchComputationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/data-governance/data-qualities/computations'].post
  update:
    x-apievangelist-phrasing:
      intent: Run data quality via the data-governance path
      effect: write
      questions:
      - How do I trigger a data quality computation through the data-governance endpoint?
      - Can the data-governance computation run pushdown inside my cloud warehouse?
      instructions:
      - text: Trigger a data quality computation for dataset {datasetId} via the data-governance endpoint.
        slots:
          datasetId: requestBody.datasetId
      - text: Run data-governance data quality on dataset {datasetId} in {executionMode} mode.
        slots:
          datasetId: requestBody.datasetId
          executionMode: requestBody.executionMode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/data-governance/data-qualities/computations/{computationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check computation status via data-governance path
      effect: read
      questions:
      - How do I poll a data quality computation on the data-governance path?
      - Has my data-governance quality computation SUCCEEDED or FAILED yet?
      instructions:
      - text: Check data-governance computation {computationId} status.
        slots:
          computationId: path.computationId
      - text: Poll the data-governance path until computation {computationId} finishes.
        slots:
          computationId: path.computationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/data-qualities/computations'].post
  update:
    x-apievangelist-phrasing:
      intent: Run data quality via the v1 path
      effect: write
      questions:
      - How do I trigger a data quality computation on the v1 data-qualities endpoint?
      - Can I sample a percentage of rows when running a v1 quality check?
      instructions:
      - text: Trigger a v1 data quality computation for dataset {datasetId}.
        slots:
          datasetId: requestBody.datasetId
      - text: Run v1 data quality on dataset {datasetId} sampling {sampleSize} in {sampleMode} mode.
        slots:
          datasetId: requestBody.datasetId
          sampleSize: requestBody.sampleSize
          sampleMode: requestBody.sampleMode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/data-qualities/computations/{computationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check computation status via the v1 path
      effect: read
      questions:
      - How do I poll a v1 data quality computation until it finishes?
      - What statuses can a v1 data-qualities computation report?
      instructions:
      - text: Check v1 data quality computation {computationId}.
        slots:
          computationId: path.computationId
      - text: Poll the v1 data-qualities path for computation {computationId} results.
        slots:
          computationId: path.computationId
      method: generated
      generated: '2026-09-26'