API Evangelist conversational phrasing for Themes API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Themes API
  version: 1.0.0
extends: openapi/qliksense-themes-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/themes'].get
  update:
    x-apievangelist-phrasing:
      intent: List themes
      effect: read
      questions:
      - Which custom themes are imported into my tenant?
      - What themes can I apply to apps in Qlik Cloud?
      instructions:
      - text: List all imported themes.
      - text: Show the themes available in the tenant.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/themes'].post
  update:
    x-apievangelist-phrasing:
      intent: Import a new theme
      effect: write
      questions:
      - How do I upload a custom theme to the tenant?
      - Does a new theme need a name different from existing ones?
      instructions:
      - text: Import a theme from file {file}.
        slots:
          file: requestBody.file
      - text: Create a new theme from data {data}.
        slots:
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/themes/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a theme
      effect: read
      questions:
      - How do I fetch a theme by its ID or name?
      - What metadata is stored for a specific theme?
      instructions:
      - text: Show theme {id}.
        slots:
          id: path.id
      - text: Get the details of the theme named {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/themes/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a theme
      effect: destructive
      questions:
      - How do I remove a theme from the tenant?
      - Can I delete a theme using its name instead of its ID?
      instructions:
      - text: Delete theme {id}.
        slots:
          id: path.id
      - text: Remove the theme named {id} from the tenant.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/themes/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a theme
      effect: write
      questions:
      - Can I replace an existing theme with a new file?
      - How do I update the data of a theme I already imported?
      instructions:
      - text: Update theme {id} with file {file}.
        slots:
          id: path.id
          file: requestBody.file
      - text: Update theme {id} using data {data}.
        slots:
          id: path.id
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/themes/{id}/file'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a theme as a zip
      effect: read
      questions:
      - How do I download all of a theme's files as a zip archive?
      - Can I export a theme to back it up?
      instructions:
      - text: Download theme {id} as a zip.
        slots:
          id: path.id
      - text: Export all files of theme {id} as a .zip archive.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/themes/{id}/file/{filepath}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download one file from a theme
      effect: read
      questions:
      - Can I download a single file, like the CSS, from a theme?
      - How do I get one specific file out of an imported theme?
      instructions:
      - text: Download file {filepath} from theme {id}.
        slots:
          filepath: path.filepath
          id: path.id
      - text: Get just the {filepath} file out of theme {id}.
        slots:
          filepath: path.filepath
          id: path.id
      method: generated
      generated: '2026-09-26'