Hive Civilization

Hive Civilization Afir Stream API

The afir-stream API from Hive Civilization — 10 operation(s) for afir-stream.

GitHub OpenAPI

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/afir-stream/health Check AFIR stream service health · Afir Stream Health #
Ask an LLM
“Is the afir-stream receipt service up?”
“Can I health-check the /v1/afir-stream endpoints specifically?”
Tell an agent
Check afir-stream health.
Ping the /v1/afir-stream service and report its status.
POST /v1/afir-stream/segment Receipt one stream segment (afir-stream path) · Afir Stream Segment #
Ask an LLM
“How do I get a signed receipt for a single audio or token segment on the afir-stream path?”
“What roles can an afir-stream segment have: model, counterparty or system side?”
Tell an agent
Receipt afir-stream segment {sequence} of session {session_id}, role {role}, hash {content_hash}.
Sign segment {sequence} for session {session_id} via afir-stream with role {role} and content hash {content_hash}.
POST /v1/afir-stream/seal Seal a session's segments (afir-stream path) · Afir Stream Seal #
Ask an LLM
“How do I seal an ordered list of segment receipts into one session receipt on afir-stream?”
“Can I declare a latency budget when sealing through afir-stream?”
Tell an agent
Seal these segment receipts via afir-stream: {segment_receipts}.
Seal session {session_id} on afir-stream from {segment_receipts} with budget {declared_budget_us} µs.
POST /v1/afir-stream/verify Verify a segment or session receipt (afir-stream) · Afir Stream Verify #
Ask an LLM
“How do I verify a sealed session receipt through the afir-stream endpoint?”
“Does afir-stream verification accept a single segment receipt too?”
Tell an agent
Verify this receipt with afir-stream: {receipt}.
Check the afir-stream signature on receipt {receipt}.
GET /v1/afir-stream/examples Get sample payloads for afir-stream · Afir Stream Examples #
Ask an LLM
“Where can I see example afir-stream segment and seal payloads?”
“Are there worked afir-stream examples to copy?”
Tell an agent
Show me the afir-stream examples.
Fetch the sample requests for /v1/afir-stream.
GET /v1/afir/health Check AFIR service health (short path) · Afir Health #
Ask an LLM
“Is the short /v1/afir endpoint healthy?”
“Can I health-check the AFIR alias without the -stream suffix?”
Tell an agent
Check /v1/afir health.
Ping the short AFIR alias and report its status.
POST /v1/afir/segment Receipt one stream segment (short /v1/afir path) · Afir Segment #
Ask an LLM
“Can I post a segment receipt to the shorter /v1/afir route instead?”
“What fields does the /v1/afir segment call require?”
Tell an agent
Using /v1/afir, receipt segment {sequence} of {session_id} as {role} with hash {content_hash}.
Post segment {sequence} for {session_id} to the short AFIR alias, role {role}, content {content_hash}.
POST /v1/afir/seal Seal a session's segments (short /v1/afir path) · Afir Seal #
Ask an LLM
“Can I seal a session using the /v1/afir alias rather than afir-stream?”
“What does the short AFIR seal return for my segment receipts?”
Tell an agent
Seal {segment_receipts} using the /v1/afir alias.
Seal session {session_id} on the short AFIR route from {segment_receipts}.
POST /v1/afir/verify Verify a receipt (short /v1/afir path) · Afir Verify #
Ask an LLM
“Can I verify an AFIR receipt through the /v1/afir alias?”
“Will the short AFIR verify route check a sealed session?”
Tell an agent
Verify {receipt} using /v1/afir.
Run the short AFIR verify on receipt {receipt}.
GET /v1/afir/examples Get sample payloads for /v1/afir · Afir Examples #
Ask an LLM
“Where are the example payloads for the short /v1/afir alias?”
“Does the /v1/afir route publish its own samples?”
Tell an agent
Show the /v1/afir examples.
Fetch sample requests for the short AFIR alias.

Documentation

📖
Documentation
https://thehiveryiq.com/developers
📖
APIReference
https://receipts.thehiveryiq.com/docs
📖
GettingStarted
https://thehiveryiq.com/agents
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/authentication/thehiveryiq-com-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/rate-limits/thehiveryiq-com-rate-limits.yml
📖
Documentation
https://thehiveryiq.com/sdk-quickstart/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/openapi/thehiveryiq-com-afir-stream-api-openapi.yml

Other Resources

🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/llms/thehiveryiq-com-receipts-llms.txt
🔗
LLMsTxt
https://receipts.thehiveryiq.com/llms.txt
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/data-model/thehiveryiq-com-data-model.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/asyncapi/thehiveryiq-com-webhooks.yml
🔗
StatusPage
https://receipts.thehiveryiq.com/status
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/conventions/thehiveryiq-com-conventions.yml
🔗
Idempotency
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/conventions/thehiveryiq-com-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/errors/thehiveryiq-com-problem-types.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/sandbox/thehiveryiq-com-sandbox.yml
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/llms/thehiveryiq-com-hivecompute-llms.txt
🔗
LLMsTxt
https://api.thehiveryiq.com/llms.txt
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/thehiveryiq-com/refs/heads/main/mcp/thehiveryiq-com-tool-crosswalk.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/thehiveryiq-com:thehiveryiq-com-afir-stream-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

thehiveryiq-com-afir-stream-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: HiveMorph v0.1 Afir Stream API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: afir-stream
paths:
  /v1/afir-stream/health:
    get:
      tags:
      - afir-stream
      summary: Afir Stream Health
      operationId: afir_stream_health_v1_afir_stream_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Afir Stream Health V1 Afir Stream Health Get
  /v1/afir-stream/segment:
    post:
      tags:
      - afir-stream
      summary: Afir Stream Segment
      operationId: afir_stream_segment_v1_afir_stream_segment_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SegmentRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Afir Stream Segment V1 Afir Stream Segment Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/afir-stream/seal:
    post:
      tags:
      - afir-stream
      summary: Afir Stream Seal
      operationId: afir_stream_seal_v1_afir_stream_seal_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SealRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Afir Stream Seal V1 Afir Stream Seal Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/afir-stream/verify:
    post:
      tags:
      - afir-stream
      summary: Afir Stream Verify
      operationId: afir_stream_verify_v1_afir_stream_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hivemorph__hive_afir_stream__routes__VerifyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Afir Stream Verify V1 Afir Stream Verify Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/afir-stream/examples:
    get:
      tags:
      - afir-stream
      summary: Afir Stream Examples
      operationId: afir_stream_examples_v1_afir_stream_examples_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Afir Stream Examples V1 Afir Stream Examples Get
  /v1/afir/health:
    get:
      tags:
      - afir-stream
      summary: Afir Health
      operationId: afir_health_v1_afir_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Afir Health V1 Afir Health Get
  /v1/afir/segment:
    post:
      tags:
      - afir-stream
      summary: Afir Segment
      operationId: afir_segment_v1_afir_segment_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SegmentRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Afir Segment V1 Afir Segment Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/afir/seal:
    post:
      tags:
      - afir-stream
      summary: Afir Seal
      operationId: afir_seal_v1_afir_seal_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SealRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Afir Seal V1 Afir Seal Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/afir/verify:
    post:
      tags:
      - afir-stream
      summary: Afir Verify
      operationId: afir_verify_v1_afir_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hivemorph__hive_afir_stream__routes__VerifyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Afir Verify V1 Afir Verify Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/afir/examples:
    get:
      tags:
      - afir-stream
      summary: Afir Examples
      operationId: afir_examples_v1_afir_examples_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Afir Examples V1 Afir Examples Get
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    SegmentRequest:
      properties:
        session_id:
          type: string
          title: Session Id
          description: session this segment belongs to
        sequence:
          type: integer
          title: Sequence
          description: 0-based segment index within the session
        role:
          type: string
          title: Role
          description: model-side | counterparty-side | system-side
        content_hash:
          type: string
          title: Content Hash
          description: hash of the segment content (audio/tokens)
        started_at_us:
          anyOf:
          - type: integer
          - type: 'null'
          title: Started At Us
        ended_at_us:
          anyOf:
          - type: integer
          - type: 'null'
          title: Ended At Us
        sign_latency_us:
          anyOf:
          - type: number
          - type: 'null'
          title: Sign Latency Us
          description: off-path signing latency for this segment (µs)
        transcript_commitment:
          type: string
          title: Transcript Commitment
          default: ''
        continuity:
          anyOf:
          - $ref: '#/components/schemas/ContinuityIn'
          - type: 'null'
        prior_commit:
          type: string
          title: Prior Commit
          default: ''
      type: object
      required:
      - session_id
      - sequence
      - role
      - content_hash
      title: SegmentRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SealRequest:
      properties:
        session_id:
          type: string
          title: Session Id
          default: ''
        segment_receipts:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Segment Receipts
          description: ordered list of segment receipts to seal
        declared_budget_us:
          type: number
          title: Declared Budget Us
          default: 100.0
        session_metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Session Metadata
      type: object
      required:
      - segment_receipts
      title: SealRequest
    hivemorph__hive_afir_stream__routes__VerifyRequest:
      properties:
        receipt:
          additionalProperties: true
          type: object
          title: Receipt
          description: a segment receipt or a sealed session receipt
      type: object
      required:
      - receipt
      title: VerifyRequest
    ContinuityIn:
      properties:
        event:
          type: string
          title: Event
          description: interruption | handoff | resume | backchannel
        continues_from_commit:
          type: string
          title: Continues From Commit
          description: commit of prior receipt
          default: ''
        detail:
          type: string
          title: Detail
          default: ''
      type: object
      required:
      - event
      title: ContinuityIn
x-provenance:
  method: harvested
  publisher: Hive Civilization
  source: https://receipts.thehiveryiq.com/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)