Hive Civilization · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Thehiveryiq Com Hive Agent Listings API

4 actions 4 updates phrasing extends openapi/thehiveryiq-com-hive-agent-listings-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 4

$.info

$.paths['/v1/agent/listings'].get

$.paths['/v1/agent/listings/{agent_id}'].get

$.paths['/v1/agent/listings/depin'].post

OpenAPI Overlay

# 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 Hive Agent Listings API
  version: 1.0.0
extends: openapi/thehiveryiq-com-hive-agent-listings-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['/v1/agent/listings'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse agent marketplace listings
      effect: read
      questions:
      - Which agents and DePIN providers are listed in the marketplace?
      - Can I filter listings to one provider category like storage or GPU compute?
      instructions:
      - text: List all agent listings.
      - text: Show {kind} listings in the {provider_category} category.
        slots:
          kind: query.kind
          provider_category: query.provider_category
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/agent/listings/{agent_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one agent listing
      effect: read
      questions:
      - What are the details of a specific marketplace listing?
      - Can I look up a listing's rate and payout details by its id?
      instructions:
      - text: Get listing {agent_id}.
        slots:
          agent_id: path.agent_id
      - text: Show the marketplace entry for {agent_id}.
        slots:
          agent_id: path.agent_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/agent/listings/depin'].post
  update:
    x-apievangelist-phrasing:
      intent: List a DePIN provider in the marketplace
      effect: write
      questions:
      - How do I list my GPU, storage or wireless capacity as a DePIN provider?
      - Which provider categories can a DePIN listing use?
      - Can I set a USDC unit rate and a payout address on my listing?
      instructions:
      - text: List DePIN provider {agent_id} in {provider_category} at {unit_rate_usdc} USDC {unit_label}.
        slots:
          agent_id: requestBody.agent_id
          provider_category: requestBody.provider_category
          unit_rate_usdc: requestBody.unit_rate_usdc
          unit_label: requestBody.unit_label
      - text: Publish GPU listing {agent_id} with {gpu_model} and {vram_gb} GB VRAM at {unit_rate_usdc} USDC, category {provider_category}.
        slots:
          agent_id: requestBody.agent_id
          gpu_model: requestBody.gpu_model
          vram_gb: requestBody.vram_gb
          unit_rate_usdc: requestBody.unit_rate_usdc
          provider_category: requestBody.provider_category
      method: generated
      generated: '2026-09-26'