# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Statsig Events API
  version: 1.0.0
extends: openapi/statsig-events-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: 4
- target: $.paths['/log_event'].post
  update:
    x-apievangelist-phrasing:
      intent: Log custom events for analytics
      effect: write
      questions:
      - How do I send custom events to Statsig for experiment analysis?
      - Can I log several events with values and metadata in one request?
      - Why is a client timestamp header required when logging events?
      instructions:
      - text: Log these events {events} with client time {clientTime}.
        slots:
          events: requestBody.events
          clientTime: header.STATSIG-CLIENT-TIME
      - text: Record a batch of custom events {events} sent at {clientTime} ms since epoch.
        slots:
          events: requestBody.events
          clientTime: header.STATSIG-CLIENT-TIME
      method: generated
      generated: '2026-09-26'
- target: $.paths['/console/v1/events'].get
  update:
    x-apievangelist-phrasing:
      intent: List recently logged events
      effect: read
      questions:
      - What events has my project received recently?
      - Does the event list cover full history or just recent traffic?
      instructions:
      - text: List recently logged events across all event names.
      - text: Show page {page} of recent events, {limit} per page.
        slots:
          page: query.page
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/events/{eventName}'].get
  update:
    x-apievangelist-phrasing:
      intent: See recent occurrences of one event
      effect: read
      questions:
      - Is a specific event like checkout_complete actually arriving?
      - Can I inspect recent payloads for one event name?
      instructions:
      - text: Show recent {eventName} events.
        slots:
          eventName: path.eventName
      - text: Fetch the last {limit} occurrences of event {eventName}.
        slots:
          eventName: path.eventName
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/events/{eventName}/metrics'].get
  update:
    x-apievangelist-phrasing:
      intent: Find metrics built on an event
      effect: read
      questions:
      - Which metrics are derived from a given event?
      - What would break if we stopped logging a particular event?
      instructions:
      - text: List the metrics that use event {eventName}.
        slots:
          eventName: path.eventName
      - text: Show metrics built from {eventName}, page {page}.
        slots:
          eventName: path.eventName
          page: query.page
      method: generated
      generated: '2026-10-01'