# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for App Store Connect Analytics Reports API
  version: 1.0.0
extends: openapi/ios-analytics-reports-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: 3
- target: $.paths['/v1/analyticsReports/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an analytics report
      effect: read
      questions:
      - What category and name does an App Store analytics report have?
      - Can I look up one analytics report by ID?
      instructions:
      - text: Show analytics report {id}.
        slots:
          id: path.id
      - text: Fetch the details of App Store analytics report {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/analyticsReports/{id}/relationships/instances'].get
  update:
    x-apievangelist-phrasing:
      intent: List IDs of an analytics report's instances
      effect: read
      questions:
      - Can I get just the instance IDs for an analytics report?
      - Which report instance identifiers exist for a given report?
      instructions:
      - text: Give me the instance IDs for analytics report {id}.
        slots:
          id: path.id
      - text: Return {limit} instance linkages for analytics report {id}.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/analyticsReports/{id}/instances'].get
  update:
    x-apievangelist-phrasing:
      intent: List instances of an analytics report
      effect: read
      questions:
      - Which daily, weekly or monthly instances of an analytics report are available?
      - Can I get the analytics report instance for a specific processing date?
      instructions:
      - text: List instances of analytics report {id}.
        slots:
          id: path.id
      - text: Show {granularity} instances of analytics report {id}.
        slots:
          id: path.id
          granularity: query.filter[granularity]
      - text: Get the instance of analytics report {id} processed on {processingDate}.
        slots:
          id: path.id
          processingDate: query.filter[processingDate]
      method: generated
      generated: '2026-10-01'