# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Flagsmith Analytics API
  version: 1.0.0
extends: openapi/flagsmith-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: 3
- target: $.paths['/api/v1/analytics/flags/'].post
  update:
    x-apievangelist-phrasing:
      intent: Report flag evaluation analytics (v1)
      effect: write
      questions:
      - Where does an SDK send flag analytics events on the original v1 endpoint?
      - Can I post feature flag usage counts to the legacy analytics endpoint?
      instructions:
      - text: Send this batch of flag analytics events to the v1 flag analytics endpoint.
      - text: Post flag usage counts using the older v1 analytics route.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/analytics/telemetry/'].post
  update:
    x-apievangelist-phrasing:
      intent: Send self-hosted installation telemetry
      effect: write
      questions:
      - How does a self-hosted Flagsmith install report its telemetry?
      - What counts does the self-hosted telemetry event include, like projects, features and users?
      instructions:
      - text: Report telemetry for this self-hosted install with {organisations} organisations, {projects} projects and {features} features.
        slots:
          organisations: requestBody.organisations
          projects: requestBody.projects
          features: requestBody.features
      - text: Send self-hosted telemetry showing {users} users in environment type {env}.
        slots:
          users: requestBody.users
          env: requestBody.env
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v2/analytics/flags/'].post
  update:
    x-apievangelist-phrasing:
      intent: Report flag evaluations (v2)
      effect: write
      questions:
      - Can I submit a list of flag evaluations to the v2 analytics endpoint?
      - Which analytics endpoint takes an evaluations array rather than raw counts?
      instructions:
      - text: Submit these flag evaluations {evaluations} to v2 analytics.
        slots:
          evaluations: requestBody.evaluations
      - text: Record the evaluation batch {evaluations} with the newer v2 flag analytics call.
        slots:
          evaluations: requestBody.evaluations
      method: generated
      generated: '2026-09-26'