# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router Analytics API
  version: 1.0.0
extends: openapi/agoragentic-com-analytics-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: 4
- target: $.paths['/v1/analytics/pageview'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a page view
      effect: write
      questions:
      - How do I track a page view once the visitor has given analytics consent?
      - What happens if I send a pageview without current consent?
      instructions:
      - text: Record a pageview of {page} under consent version {consent_version}.
        slots:
          page: requestBody.page
          consent_version: requestBody.consent_version
      - text: Log a visit to {page} from referrer {referrer} for session {session_id}, consent {consent_version}.
        slots:
          page: requestBody.page
          referrer: requestBody.referrer
          session_id: requestBody.session_id
          consent_version: requestBody.consent_version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/analytics/event'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a custom analytics event
      effect: write
      questions:
      - How do I track a custom event like a button click with a category and label?
      - Can I attach a numeric value to a tracked event?
      instructions:
      - text: Track event {event} with consent version {consent_version}.
        slots:
          event: requestBody.event
          consent_version: requestBody.consent_version
      - text: Record event {event} in category {category} labeled {label} with value {value}, consent {consent_version}.
        slots:
          event: requestBody.event
          category: requestBody.category
          label: requestBody.label
          value: requestBody.value
          consent_version: requestBody.consent_version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/analytics/funnel'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a funnel step
      effect: write
      questions:
      - How do I log that a user reached a particular step in a conversion funnel?
      - Can funnel steps carry a name and extra metadata?
      instructions:
      - text: Record step {step} of funnel {funnel} under consent {consent_version}.
        slots:
          step: requestBody.step
          funnel: requestBody.funnel
          consent_version: requestBody.consent_version
      - text: Log funnel {funnel} step {step} named {step_name} for session {session_id}, consent {consent_version}.
        slots:
          funnel: requestBody.funnel
          step: requestBody.step
          step_name: requestBody.step_name
          session_id: requestBody.session_id
          consent_version: requestBody.consent_version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/audit/logs'].get
  update:
    x-apievangelist-phrasing:
      intent: View the platform audit trail
      effect: read
      questions:
      - Where can I see the immutable log of platform events?
      - How many audit log entries can I pull at once?
      instructions:
      - text: Show the platform audit log.
      - text: Get the latest {limit} audit trail entries.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'