# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Tenant Settings API
  version: 1.0.0
extends: openapi/qliksense-tenant-settings-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: 7
- target: $.paths['/api/v1/tenant-settings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the tenant's settings
      effect: read
      questions:
      - What settings are currently saved for my Qlik Cloud tenant?
      - Which permission do I need to read tenant settings?
      instructions:
      - text: Show my tenant settings.
      - text: Get the settings entry for this tenant.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/tenant-settings'].post
  update:
    x-apievangelist-phrasing:
      intent: Create the tenant settings entry
      effect: write
      questions:
      - How do I set a preferred start page when the tenant has no settings yet?
      - Can I configure what users see when they have no access while creating tenant settings?
      instructions:
      - text: Create tenant settings with preferred start page {preferredStartPage}.
        slots:
          preferredStartPage: requestBody.preferredStartPage
      - text: Create the tenant settings entry with no-access customization {customizeNoAccess}.
        slots:
          customizeNoAccess: requestBody.customizeNoAccess
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/tenant-settings'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete the tenant settings
      effect: destructive
      questions:
      - How do I remove all saved tenant settings?
      - Which permission lets me delete the tenant settings entry?
      instructions:
      - text: Delete this tenant's settings.
      - text: Remove the saved tenant settings entry entirely.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/tenant-settings'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update existing tenant settings
      effect: write
      questions:
      - Can I change the tenant's existing settings without recreating them?
      - Is there a separate permission for updating tenant settings?
      instructions:
      - text: Update the existing tenant settings.
      - text: Change the preferred start page in the saved tenant settings.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/tenant-settings/actions/toggle-cross-region-data-processing'].post
  update:
    x-apievangelist-phrasing:
      intent: Turn cross-region data processing on or off
      effect: write
      questions:
      - Can I allow my tenant's data to be processed in another region?
      - What consent header must I send to enable cross-region data processing?
      instructions:
      - text: Set cross-region data processing for the tenant to {value}.
        slots:
          value: requestBody.value
      - text: 'Allow cross-region data processing for this tenant: {value}.'
        slots:
          value: requestBody.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/tenant-settings/actions/toggle-cross-region-inference'].post
  update:
    x-apievangelist-phrasing:
      intent: Turn cross-region AI inference on or off
      effect: write
      questions:
      - How do I let my tenant run AI inference in another region?
      - Does toggling cross-region inference create tenant settings if none exist?
      instructions:
      - text: Set cross-region inference for the tenant to {value}.
        slots:
          value: requestBody.value
      - text: 'Allow AI inference to run in another region for this tenant: {value}.'
        slots:
          value: requestBody.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/tenant-settings/start-pages'].get
  update:
    x-apievangelist-phrasing:
      intent: List available start pages
      effect: read
      questions:
      - Which start pages can I choose from for the tenant?
      - What options exist for the tenant's landing page?
      instructions:
      - text: List the start pages available in tenant settings.
      - text: Show which start page options the tenant can choose.
      method: generated
      generated: '2026-09-26'