# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Dremio Intelligent Lakehouse REST PAT API
  version: 1.0.0
extends: openapi/dremio-intelligent-lakehouse-platform-pat-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: 2
- target: $.paths['/users/{userId}/tokens'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's personal access tokens
      effect: read
      questions:
      - Which personal access tokens does a given user have?
      - How can I audit the PATs issued to someone?
      instructions:
      - text: List the personal access tokens for user {userId}.
        slots:
          userId: path.userId
      - text: Show me every PAT that user {userId} owns.
        slots:
          userId: path.userId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{userId}/tokens'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a personal access token for a user
      effect: write
      questions:
      - How do I generate a new personal access token for a user?
      - Can I issue a PAT for scripting instead of using a password?
      instructions:
      - text: Create a personal access token for user {userId}.
        slots:
          userId: path.userId
      - text: Generate a new PAT for {userId} so they can use the API.
        slots:
          userId: path.userId
      method: generated
      generated: '2026-10-01'