API Evangelist conversational phrasing for Audits API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Audits API
  version: 1.0.0
extends: openapi/qliksense-audits-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/audits'].get
  update:
    x-apievangelist-phrasing:
      intent: List recent audit events
      effect: read
      questions:
      - Who did what in my Qlik tenant over the last few weeks?
      - Can I filter audit events by user or event type?
      - How long are recent audit events kept?
      instructions:
      - text: List recent audit events.
      - text: Show audit events of type {eventType} by user {userId}.
        slots:
          eventType: query.eventType
          userId: query.userId
      - text: List audit events from source {source}.
        slots:
          source: query.source
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/audits/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an audit event
      effect: read
      questions:
      - How do I see the full details of one audit event?
      - What was recorded in a particular audit entry?
      instructions:
      - text: Get audit event {id}.
        slots:
          id: path.id
      - text: Show me the details of audit entry {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/audits/actions/fetch-consumption-app'].post
  update:
    x-apievangelist-phrasing:
      intent: Export the consumption usage app
      effect: read
      questions:
      - How do I get a usage report app for my capacity subscription?
      - Who is allowed to export the consumption QVF?
      instructions:
      - text: Export the consumption app for my tenant.
      - text: Download the QVF with subscription usage data.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/audits/archive'].get
  update:
    x-apievangelist-phrasing:
      intent: List archived audit events for a date
      effect: read
      questions:
      - Where can I find audit events older than 90 days?
      - Can I pull archived audit logs for a specific day?
      instructions:
      - text: Get archived audit events for {date}.
        slots:
          date: query.date
      - text: Retrieve the long-term audit archive for day {date}.
        slots:
          date: query.date
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/audits/settings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get audit service settings
      effect: read
      questions:
      - How is the audit service configured on my tenant?
      - What configuration options does the audit server run with?
      instructions:
      - text: Show the audit service configuration.
      - text: Get the audit server settings.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/audits/sources'].get
  update:
    x-apievangelist-phrasing:
      intent: List audit event sources
      effect: read
      questions:
      - Which services can produce audit events?
      - What event sources can I filter audits on?
      instructions:
      - text: List the possible audit event sources.
      - text: Show which sources emit audit events here.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/audits/types'].get
  update:
    x-apievangelist-phrasing:
      intent: List audit event types
      effect: read
      questions:
      - What kinds of audit events can occur in my tenant?
      - Which event types are available for audit filtering?
      instructions:
      - text: List the possible audit event types.
      - text: Show every audit event type for this tenant.
      method: generated
      generated: '2026-09-26'