# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Console Metrics (Warehouse Native) API
  version: 1.0.0
extends: openapi/statsig-metrics-warehouse-native-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: 7
- target: $.paths['/console/v1/metrics/{id}/reload'].post
  update:
    x-apievangelist-phrasing:
      intent: Reload a warehouse metric's data
      effect: write
      questions:
      - How do I recompute a metric after fixing its source data?
      - Can I reload a metric incrementally instead of fully?
      instructions:
      - text: Reload data for metric {id}.
        slots:
          id: path.id
      - text: Run an incremental reload ({incremental}) of metric {id}.
        slots:
          id: path.id
          incremental: query.incremental
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/metrics/metric_source'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a metric source
      effect: write
      questions:
      - How do I define a metric source from a warehouse query?
      - Can a metric source point at a table instead of custom SQL?
      instructions:
      - text: Create metric source {name} from SQL {sql} with timestamp column {timestampColumn} and mapping {idTypeMapping}.
        slots:
          name: requestBody.name
          sql: requestBody.sql
          timestampColumn: requestBody.timestampColumn
          idTypeMapping: requestBody.idTypeMapping
      - text: Add metric source {name} with CURE disabled {disableCURE}, query {sql}, time column {timestampColumn}, units {idTypeMapping}.
        slots:
          name: requestBody.name
          disableCURE: requestBody.disableCURE
          sql: requestBody.sql
          timestampColumn: requestBody.timestampColumn
          idTypeMapping: requestBody.idTypeMapping
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/metrics/metric_source/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a metric source
      effect: read
      questions:
      - What SQL backs a particular metric source?
      - Can I read one metric source by name?
      instructions:
      - text: Show metric source {name}.
        slots:
          name: path.name
      - text: Get the query and columns of metric source {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/metrics/metric_source/{name}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a metric source
      effect: write
      questions:
      - How do I change the query behind a metric source?
      - Can I mark a metric source as verified while updating it?
      instructions:
      - text: Update metric source {name} with SQL {sql}, timestamp column {timestampColumn} and mapping {idTypeMapping}.
        slots:
          name: path.name
          sql: requestBody.sql
          timestampColumn: requestBody.timestampColumn
          idTypeMapping: requestBody.idTypeMapping
      - text: Change metric source {name} to query {sql}, time {timestampColumn}, units {idTypeMapping}, and set verified to {isVerified}.
        slots:
          name: path.name
          sql: requestBody.sql
          timestampColumn: requestBody.timestampColumn
          idTypeMapping: requestBody.idTypeMapping
          isVerified: requestBody.isVerified
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/metrics/metric_source/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a metric source
      effect: destructive
      questions:
      - Can I delete a metric source we stopped using?
      - Is removing a metric source permanent?
      instructions:
      - text: Delete metric source {name}.
        slots:
          name: path.name
      - text: Remove the metric source called {name}.
        slots:
          name: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/metrics/metric_source/{name}/metrics'].get
  update:
    x-apievangelist-phrasing:
      intent: List metrics built on a metric source
      effect: read
      questions:
      - Which metrics depend on a given metric source?
      - What would be affected if I changed a metric source?
      instructions:
      - text: List the metrics that use metric source {name}.
        slots:
          name: path.name
      - text: Show page {page} of metrics built on source {name}.
        slots:
          name: path.name
          page: query.page
      method: generated
      generated: '2026-10-01'
- target: $.paths['/console/v1/metrics/metric_source/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List metric sources
      effect: read
      questions:
      - What metric sources are defined in our warehouse project?
      - Can I page through all metric sources?
      instructions:
      - text: List all metric sources.
      - text: Show metric sources page {page}, {limit} per page.
        slots:
          page: query.page
          limit: query.limit
      method: generated
      generated: '2026-10-01'