Hive Civilization · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Thehiveryiq Com Ops API

7 actions 7 updates phrasing extends openapi/thehiveryiq-com-ops-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Hive Civilization's API. It is a proposal applied on top of the contract, not a document Hive Civilization publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 7

$.info
$.paths['/v1/ops/health'].get
$.paths['/v1/ops/revenue'].get
$.paths['/v1/ops/calls'].get
$.paths['/v1/ops/deploys'].get
$.paths['/v1/ops/traffic'].get
$.paths['/v1/ops/full'].get

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Thehiveryiq Com Ops API
  version: 1.0.0
extends: openapi/thehiveryiq-com-ops-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: 6
- target: $.paths['/v1/ops/health'].get
  update:
    x-apievangelist-phrasing:
      intent: Get aggregate health for every endpoint group
      effect: read
      questions:
      - What are the p50, p95 and error rates across every endpoint prefix?
      - Which endpoint groups are slow or erroring right now?
      instructions:
      - text: Show aggregate health for all endpoint prefixes.
      - text: List latency percentiles and error rate per route prefix.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/ops/revenue'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a revenue snapshot
      effect: read
      questions:
      - How much revenue has come in through card payments and the USDC treasury?
      - What's the current on-chain USDC treasury balance?
      instructions:
      - text: Show the current revenue snapshot.
      - text: Report gross card revenue and USDC treasury balance.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/ops/calls'].get
  update:
    x-apievangelist-phrasing:
      intent: List the busiest endpoints in the last minute
      effect: read
      questions:
      - Which endpoints are getting the most calls per minute right now?
      - What are the top 20 routes by request rate?
      instructions:
      - text: Show the top endpoints by calls per minute.
      - text: List per-endpoint call counts for the last 60 seconds.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/ops/deploys'].get
  update:
    x-apievangelist-phrasing:
      intent: Show the last deploy for each service
      effect: read
      questions:
      - When was each service last deployed and at what commit?
      - Which git SHA is running for each service?
      instructions:
      - text: Show the latest deploy SHA and time per service.
      - text: List recent deploys across services.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/ops/traffic'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the public traffic snapshot
      effect: read
      questions:
      - Is there a public traffic summary I can show on a homepage tile?
      - How busy is the platform right now, publicly?
      instructions:
      - text: Get the public traffic HUD snapshot.
      - text: Show the lean public traffic stats.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/ops/full'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the full operator traffic view
      effect: read
      questions:
      - How do I see the full operator view of every service, repo and perimeter detail?
      - What key do I need for the detailed ops traffic view?
      instructions:
      - text: Show the full operator view using ops key {key}.
        slots:
          key: query.key
      - text: Pull every service and perimeter detail with key {key}.
        slots:
          key: query.key
      method: generated
      generated: '2026-09-26'