API Evangelist conversational phrasing for temp-contents Temporary contents API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for temp-contents Temporary contents API
  version: 1.0.0
extends: openapi/qliksense-temporary-contents-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: 5
- target: $.paths['/api/v1/temp-contents'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a temporary file
      effect: write
      questions:
      - How do I upload a file that only needs to live for a short time?
      - Can I set how long an uploaded temporary file is kept before it expires?
      instructions:
      - text: Upload {filename} as temporary content.
        slots:
          filename: query.filename
      - text: Upload {filename} as a temporary file that expires after {ttl}.
        slots:
          filename: query.filename
          ttl: query.ttl
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/temp-contents/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a temporary file
      effect: read
      questions:
      - Can I download just a byte range of a temporary file?
      - What happens if I try to download a temporary file that has expired?
      instructions:
      - text: Download temporary file {id}.
        slots:
          id: path.id
      - text: Fetch bytes {Range} of temporary file {id}.
        slots:
          Range: header.Range
          id: path.id
      - text: Open temporary file {id} inline for preview with inline set to {inline}.
        slots:
          id: path.id
          inline: query.inline
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/temp-contents/{id}/details'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a temporary file's metadata
      effect: read
      questions:
      - What is the name, size and expiry of a temporary file?
      - Can I check whether a temporary file is still valid without downloading it?
      instructions:
      - text: Show the details of temporary file {id}.
        slots:
          id: path.id
      - text: Check whether temporary file {id} has expired.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/temp-contents/files'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a resumable upload (tus)
      effect: write
      questions:
      - How do I start a resumable upload for a large file using the tus protocol?
      - Which headers are needed to create a tus upload resource?
      instructions:
      - text: Create a tus upload of {Upload-Length} bytes using tus version {Tus-Resumable}.
        slots:
          Upload-Length: header.Upload-Length
          Tus-Resumable: header.Tus-Resumable
      - text: Start a resumable upload of {Upload-Length} bytes on tus {Tus-Resumable} with metadata {Upload-Metadata}.
        slots:
          Upload-Length: header.Upload-Length
          Tus-Resumable: header.Tus-Resumable
          Upload-Metadata: header.Upload-Metadata
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/temp-contents/files/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Send a chunk of a resumable upload (tus)
      effect: write
      questions:
      - How do I send the next chunk of a resumable tus upload?
      - What content type must a tus chunk use?
      instructions:
      - text: Append bytes to upload {id} at offset {Upload-Offset} with tus {Tus-Resumable} and content type {Content-Type}.
        slots:
          id: path.id
          Upload-Offset: header.Upload-Offset
          Tus-Resumable: header.Tus-Resumable
          Content-Type: header.Content-Type
      - text: Upload the next chunk of tus upload {id} starting at byte {Upload-Offset}, tus {Tus-Resumable}, type {Content-Type}.
        slots:
          id: path.id
          Upload-Offset: header.Upload-Offset
          Tus-Resumable: header.Tus-Resumable
          Content-Type: header.Content-Type
      method: generated
      generated: '2026-09-26'