API Evangelist conversational phrasing for Spaces API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Spaces API
  version: 1.0.0
extends: openapi/qliksense-spaces-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/spaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List spaces
      effect: read
      questions:
      - Which spaces do I have access to in Qlik Cloud?
      - Can I list only managed or shared spaces owned by a certain user?
      instructions:
      - text: List spaces of type {type}.
        slots:
          type: query.type
      - text: Find spaces named {name}.
        slots:
          name: query.name
      - text: Show spaces owned by {ownerId}.
        slots:
          ownerId: query.ownerId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/spaces'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a space
      effect: write
      questions:
      - How do I create a new shared or managed space?
      - Do space names have to be unique when creating one?
      instructions:
      - text: Create a {type} space named {name}.
        slots:
          type: requestBody.type
          name: requestBody.name
      - text: Create space {name} of type {type} described as {description}.
        slots:
          name: requestBody.name
          type: requestBody.type
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/spaces/{spaceId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a space
      effect: read
      questions:
      - Where do I see the details of a single space?
      - Who owns a particular space?
      instructions:
      - text: Get space {spaceId}.
        slots:
          spaceId: path.spaceId
      - text: Show details for space {spaceId}.
        slots:
          spaceId: path.spaceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/spaces/{spaceId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a space's name, owner and description
      effect: write
      questions:
      - Can I update all of a space's properties in one full replace?
      - Can I transfer a space to a new owner?
      instructions:
      - text: Fully update space {spaceId} with name {name} and description {description}.
        slots:
          spaceId: path.spaceId
          name: requestBody.name
          description: requestBody.description
      - text: Transfer space {spaceId} to owner {ownerId}.
        slots:
          spaceId: path.spaceId
          ownerId: requestBody.ownerId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/spaces/{spaceId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a space
      effect: destructive
      questions:
      - What happens to content if I delete a space before emptying it?
      - Can I delete a space I no longer use?
      instructions:
      - text: Delete space {spaceId}.
        slots:
          spaceId: path.spaceId
      - text: Remove space {spaceId} permanently.
        slots:
          spaceId: path.spaceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/spaces/{spaceId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change individual space properties
      effect: write
      questions:
      - Can I change just one property of a space without resending the rest?
      - What is the partial-update option for a space?
      instructions:
      - text: Patch only the description of space {spaceId}.
        slots:
          spaceId: path.spaceId
      - text: Apply a partial update to space {spaceId}.
        slots:
          spaceId: path.spaceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/spaces/types'].get
  update:
    x-apievangelist-phrasing:
      intent: List available space types
      effect: read
      questions:
      - Which space types are available in my tenant?
      - Is the data space type enabled here?
      instructions:
      - text: List the space types available in this tenant.
      - text: Show the distinct space types I can create.
      method: generated
      generated: '2026-09-26'