# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Postman Analytics API
  version: 1.0.0
extends: openapi/postman-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: 2
- target: $.paths['/analytics'].get
  update:
    x-apievangelist-phrasing:
      intent: Get workspace and API usage analytics
      effect: read
      questions:
      - How much traffic and success are my public and partner workspaces getting?
      - Can I break analytics down by period or response status?
      - Which metrics can I pull for a given resource over the last 30 days?
      instructions:
      - text: Get {metrics} for resource {resource}.
        slots:
          metrics: query.metrics
          resource: query.resource
      - text: Show {metrics} on {resource} for {workspaceType} workspaces over {duration}.
        slots:
          metrics: query.metrics
          resource: query.resource
          workspaceType: query.workspaceType
          duration: query.duration
      method: generated
      generated: '2026-09-26'
- target: $.paths['/analytics-metadata'].get
  update:
    x-apievangelist-phrasing:
      intent: List available analytics resources and metrics
      effect: read
      questions:
      - What analytics resources and metrics can I query?
      - Where do I find valid metric names to use in an analytics request?
      instructions:
      - text: List all analytics resources and their metrics.
      - text: Show the metrics available for analytics resources {resources}.
        slots:
          resources: query.resources
      method: generated
      generated: '2026-09-26'