API Evangelist conversational phrasing for Items API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Items API
  version: 1.0.0
extends: openapi/qliksense-items-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: 6
- target: $.paths['/api/v1/items'].get
  update:
    x-apievangelist-phrasing:
      intent: List items I can access
      effect: read
      questions:
      - Which apps and other items can I access in Qlik Cloud?
      - Can I list items in a specific space or of a certain resource type?
      - How do I find items shared with me?
      instructions:
      - text: List the items I have access to.
      - text: List items of type {resourceType} in space {spaceId}.
        slots:
          resourceType: query.resourceType
          spaceId: query.spaceId
      - text: Find items named {name}.
        slots:
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/items/{itemId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an item
      effect: read
      questions:
      - How do I look up one item's metadata?
      - What resource does a given item point to?
      instructions:
      - text: Get item {itemId}.
        slots:
          itemId: path.itemId
      - text: Show metadata for item {itemId}.
        slots:
          itemId: path.itemId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/items/{itemId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an item
      effect: write
      questions:
      - Can I rename an item or change its description?
      - How do I unset a field on an item?
      instructions:
      - text: Update item {itemId} of type {resourceType}.
        slots:
          itemId: path.itemId
          resourceType: requestBody.resourceType
      - text: Rename item {itemId} to {name}.
        slots:
          itemId: path.itemId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/items/{itemId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an item
      effect: destructive
      questions:
      - Does deleting an item remove it from collections too?
      - How do I delete an item?
      instructions:
      - text: Delete item {itemId}.
        slots:
          itemId: path.itemId
      - text: Remove item {itemId} and take it out of all collections.
        slots:
          itemId: path.itemId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/items/{itemId}/collections'].get
  update:
    x-apievangelist-phrasing:
      intent: List collections an item belongs to
      effect: read
      questions:
      - Which collections and tags is an item in?
      - Can I see what collections contain a particular app?
      instructions:
      - text: List the collections of item {itemId}.
        slots:
          itemId: path.itemId
      - text: Show collections of type {type} containing item {itemId}.
        slots:
          type: query.type
          itemId: path.itemId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/items/{itemId}/publisheditems'].get
  update:
    x-apievangelist-phrasing:
      intent: List published copies of an item
      effect: read
      questions:
      - Where are the published copies of my app?
      - Can I find every published version of a source item?
      instructions:
      - text: List published items for item {itemId}.
        slots:
          itemId: path.itemId
      - text: Show where item {itemId} has been published.
        slots:
          itemId: path.itemId
      method: generated
      generated: '2026-09-26'