# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Edge Impulse Metrics API
  version: 1.0.0
extends: openapi/edge-impulse-metrics-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['/api-metrics'].get
  update:
    x-apievangelist-phrasing:
      intent: Get public platform usage numbers
      effect: read
      questions:
      - How many projects and data samples are on Edge Impulse right now?
      - How often are the public platform compute and project counts refreshed?
      instructions:
      - text: Get the public metrics on total projects, compute and data samples.
      - text: Show the platform-wide public usage counts.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api-metrics/website/pageviews'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a website pageview
      effect: write
      questions:
      - How do I record a page view for website analytics?
      - Can I include the referrer when logging a website page view?
      instructions:
      - text: Log a pageview of {pageUrl} for session {sessionId}.
        slots:
          pageUrl: requestBody.pageUrl
          sessionId: requestBody.sessionId
      - text: Record that session {sessionId} viewed {pageUrl} coming from {pageReferrer}.
        slots:
          sessionId: requestBody.sessionId
          pageUrl: requestBody.pageUrl
          pageReferrer: requestBody.pageReferrer
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api-metrics/events'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a named analytics event
      effect: write
      questions:
      - How do I send a custom analytics event with properties?
      - Can I log an analytics event without a session id?
      instructions:
      - text: Log the analytics event {eventName} with properties {eventProperties}.
        slots:
          eventName: requestBody.eventName
          eventProperties: requestBody.eventProperties
      - text: Track event {eventName} for session {sessionId} with properties {eventProperties}.
        slots:
          eventName: requestBody.eventName
          sessionId: requestBody.sessionId
          eventProperties: requestBody.eventProperties
      method: generated
      generated: '2026-10-01'