# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Swetrix Statistics Sessions API
  version: 1.0.0
extends: openapi/swetrix-sessions-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: 2
- target: $.paths['/v1/log/sessions'].get
  update:
    x-apievangelist-phrasing:
      intent: List individual visitor sessions
      effect: read
      questions:
      - Can I browse individual visitor sessions from last week?
      - What's the most sessions I can pull in one request?
      instructions:
      - text: List visitor sessions for project {pid} over {period}.
        slots:
          pid: query.pid
          period: query.period
      - text: Show {take} sessions for project {pid} over {period} matching filters {filters}.
        slots:
          take: query.take
          pid: query.pid
          period: query.period
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/log/session'].get
  update:
    x-apievangelist-phrasing:
      intent: View one visitor session's pages and details
      effect: read
      questions:
      - Which pages did a particular visitor go through in their session?
      - How do I open the full detail of a single session by its ID?
      instructions:
      - text: Get session {psid} in project {pid}.
        slots:
          psid: query.psid
          pid: query.pid
      - text: Show the pages visited during session {psid} on project {pid}.
        slots:
          psid: query.psid
          pid: query.pid
      method: generated
      generated: '2026-09-26'