API Evangelist conversational phrasing for data-files Datafiles API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for data-files Datafiles API
  version: 1.0.0
extends: openapi/qliksense-datafiles-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: 12
- target: $.paths['/api/v1/data-files'].get
  update:
    x-apievangelist-phrasing:
      intent: List data files and folders
      effect: read
      questions:
      - Which data files have been uploaded to my tenant?
      - Can I list only the files in one folder or owned by one user?
      instructions:
      - text: List my data files.
      - text: List data files in folder {folderPath} for connection {connectionId}.
        slots:
          folderPath: query.folderPath
          connectionId: query.connectionId
      - text: List data files owned by {ownerId}, {limit} per page.
        slots:
          ownerId: query.ownerId
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/data-files'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a data file or create a folder
      effect: write
      questions:
      - Can I upload a CSV or Excel file for apps to load?
      - Is it possible to create a new data folder through the API?
      instructions:
      - text: Upload data file {File}.
        slots:
          File: requestBody.File
      - text: Create a new data folder described by {Json}.
        slots:
          Json: requestBody.Json
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/data-files/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a data file's details
      effect: read
      questions:
      - Can I see the size and owner of one uploaded data file?
      - Where do I get the descriptive info for a single data file?
      instructions:
      - text: Show data file {id}.
        slots:
          id: path.id
      - text: Get size, owner and location of data file {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/data-files/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Re-upload a data file or update a folder
      effect: write
      questions:
      - Can I overwrite an existing data file with a newer version?
      - Is it possible to rename an existing data folder?
      instructions:
      - text: Re-upload data file {id} with {File}.
        slots:
          id: path.id
          File: requestBody.File
      - text: Update existing folder {id} using {Json}.
        slots:
          id: path.id
          Json: requestBody.Json
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/data-files/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a data file or folder
      effect: destructive
      questions:
      - Can I delete one uploaded data file?
      - Will deleting a folder remove what is inside it?
      instructions:
      - text: Delete data file {id}.
        slots:
          id: path.id
      - text: Remove the single data folder {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/data-files/{id}/actions/change-owner'].post
  update:
    x-apievangelist-phrasing:
      intent: Change a data file's owner
      effect: write
      questions:
      - Can an admin reassign a data file to another user?
      - Who owns a data file after its creator leaves?
      instructions:
      - text: Make {ownerId} the owner of data file {id}.
        slots:
          ownerId: requestBody.ownerId
          id: path.id
      - text: Reassign data folder {id} to user {ownerId}.
        slots:
          id: path.id
          ownerId: requestBody.ownerId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/data-files/{id}/actions/change-space'].post
  update:
    x-apievangelist-phrasing:
      intent: Move one data file to another space
      effect: write
      questions:
      - Can I move a single data file into a shared space?
      - Is it possible to move one data folder out of a personal space?
      instructions:
      - text: Move data file {id} to space {spaceId}.
        slots:
          id: path.id
          spaceId: requestBody.spaceId
      - text: Relocate the single folder {id} into space {spaceId}.
        slots:
          id: path.id
          spaceId: requestBody.spaceId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/data-files/actions/change-space'].post
  update:
    x-apievangelist-phrasing:
      intent: Move many data files between spaces
      effect: write
      questions:
      - Can I move a whole batch of data files to another space in one call?
      - Is there a bulk space change for data files and folders?
      instructions:
      - text: 'Move these data files to new spaces in one batch: {changeSpace}.'
        slots:
          changeSpace: requestBody.change-space
      - text: Bulk relocate data files and folders as listed in {changeSpace}.
        slots:
          changeSpace: requestBody.change-space
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/data-files/actions/delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Bulk delete data files
      effect: destructive
      questions:
      - Can I delete a batch of data files in a single request?
      - Is there a way to delete every data file in my personal space at once?
      instructions:
      - text: 'Delete these data files in one batch: {delete}.'
        slots:
          delete: requestBody.delete
      - text: Delete all data files in my personal space with deleteAllFromPersonalSpace {deleteAllFromPersonalSpace}.
        slots:
          deleteAllFromPersonalSpace: requestBody.deleteAllFromPersonalSpace
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/data-files/connections'].get
  update:
    x-apievangelist-phrasing:
      intent: List built-in data file connections
      effect: read
      questions:
      - Which built-in connections does the engine use to load data files?
      - Can I see the data file connection for each space I have access to?
      instructions:
      - text: List the built-in data file connections.
      - text: List data file connections for space {spaceId}.
        slots:
          spaceId: query.spaceId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/data-files/connections/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a built-in data file connection
      effect: read
      questions:
      - Can I look up one of the engine's built-in data file connections by ID?
      - What details does a single data file connection return?
      instructions:
      - text: Show data file connection {id}.
        slots:
          id: path.id
      - text: Get the built-in engine connection {id} used for data files.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/v1/data-files/quotas'].get
  update:
    x-apievangelist-phrasing:
      intent: Check my data file storage quota
      effect: read
      questions:
      - How much data file storage have I used and how much is left?
      - What is the maximum size allowed for an uploaded data file?
      instructions:
      - text: Show my data file quota.
      - text: Check how much data file storage I have left.
      method: generated
      generated: '2026-10-01'