API Evangelist conversational phrasing for Licenses API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Licenses API
  version: 1.0.0
extends: openapi/qliksense-licenses-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 9
- target: $.paths['/api/v1/licenses/assignments'].get
  update:
    x-apievangelist-phrasing:
      intent: List license assignments
      effect: read
      questions:
      - Which users have a professional or analyzer license assigned?
      - Can I find license assignments for users that no longer exist?
      instructions:
      - text: List license assignments in my tenant.
      - text: List license assignments matching {filter}, {limit} per page.
        slots:
          filter: query.filter
          limit: query.limit
      - text: List orphaned license assignments with orphans {orphans}.
        slots:
          orphans: query.orphans
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/licenses/assignments/actions/add'].post
  update:
    x-apievangelist-phrasing:
      intent: Assign licenses to users
      effect: write
      questions:
      - Can I give several users a license in one request?
      - Which license types can I assign to new users?
      instructions:
      - text: 'Assign licenses to these users: {add}.'
        slots:
          add: requestBody.add
      - text: Grant license access as listed in {add}.
        slots:
          add: requestBody.add
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/licenses/assignments/actions/delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove licenses from users
      effect: destructive
      questions:
      - Can I free up licenses by removing them from departed users?
      - Is it possible to revoke license access for several users at once?
      instructions:
      - text: 'Remove license access for these users: {delete}.'
        slots:
          delete: requestBody.delete
      - text: Revoke the license assignments listed in {delete}.
        slots:
          delete: requestBody.delete
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/licenses/assignments/actions/update'].post
  update:
    x-apievangelist-phrasing:
      intent: Change users' license type
      effect: write
      questions:
      - Can I change the license access a user already has?
      - Can several users' license types be changed in one request?
      instructions:
      - text: 'Update license access for these users: {update}.'
        slots:
          update: requestBody.update
      - text: Change license types as listed in {update}.
        slots:
          update: requestBody.update
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/licenses/consumption'].get
  update:
    x-apievangelist-phrasing:
      intent: Get license consumption
      effect: read
      questions:
      - How much of our license has the tenant consumed so far?
      - Can I filter license consumption records?
      instructions:
      - text: Show license consumption for my tenant.
      - text: List license consumption records matching {filter}.
        slots:
          filter: query.filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/licenses/overview'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the tenant license overview
      effect: read
      questions:
      - What license is applied to my tenant and how many seats does it include?
      - Where do I see the general details of my Qlik Cloud license?
      instructions:
      - text: Show the license overview for my tenant.
      - text: Summarize the license applied to this tenant.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/licenses/settings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get license auto-assign settings
      effect: read
      questions:
      - Are new users automatically given a license in my tenant?
      - Which license types are set to auto-assign?
      instructions:
      - text: Show the license auto-assign settings.
      - text: Check whether professional licenses auto-assign.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/licenses/settings'].put
  update:
    x-apievangelist-phrasing:
      intent: Set license auto-assign settings
      effect: write
      questions:
      - Can I turn on automatic license assignment for new users?
      - Can I auto-assign analyzer licenses but not professional ones?
      instructions:
      - text: Set auto-assign analyzer to {autoAssignAnalyzer} and professional to {autoAssignProfessional}.
        slots:
          autoAssignAnalyzer: requestBody.autoAssignAnalyzer
          autoAssignProfessional: requestBody.autoAssignProfessional
      - text: Turn professional license auto-assign to {autoAssignProfessional}.
        slots:
          autoAssignProfessional: requestBody.autoAssignProfessional
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/licenses/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the tenant license status
      effect: read
      questions:
      - What is the current license status of my tenant?
      - Where do I check the current status of my license?
      instructions:
      - text: Show my tenant license status.
      - text: Check whether the tenant license is still valid.
      method: generated
      generated: '2026-10-01'