Hive Civilization

Hive Civilization Amplify API

The amplify API from Hive Civilization — 9 operation(s) for amplify.

GitHub OpenAPI

Operations 9

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

POST /v1/amplify/call Run a prompt through the Amplify loop · Call #
Ask an LLM
“How do I send a prompt through Amplify so it's compressed, answered and certified?”
“Can I choose the model, max tokens and temperature for an Amplify call?”
Tell an agent
Run prompt {prompt} through Amplify for tenant {tenant_did}.
Call Amplify with {prompt} on model {model} for tenant {tenant_did}, capped at {max_tokens} tokens.
POST /v1/amplify/corpus/append Add an entry to a tenant's Amplify corpus · Corpus Append #
Ask an LLM
“How can I add my own content to the corpus Amplify draws on?”
“What kinds of entries can I append to a tenant corpus?”
Tell an agent
Append {content} as a {kind} entry to tenant {tenant_did}'s corpus.
Save this {kind} to the Amplify corpus for {tenant_did}: {content}.
GET /v1/amplify/corpus/retrieve Search a tenant's Amplify corpus · Corpus Retrieve #
Ask an LLM
“Can I pull the corpus entries most relevant to a query?”
“How many matches can a corpus retrieval return?”
Tell an agent
Search tenant {tenant_did}'s corpus for {query}.
Retrieve the top {k} corpus entries for {query} in tenant {tenant_did}.
GET /v1/amplify/corpus/stats Get Amplify corpus statistics · Corpus Stats #
Ask an LLM
“How big is my tenant's Amplify corpus?”
“What stats does Amplify keep about the corpus?”
Tell an agent
Show corpus stats for tenant {tenant_did}.
Get overall Amplify corpus statistics.
POST /v1/amplify/sign Certify an LLM response you ran yourself · Amplify Sign #
Ask an LLM
“Can I get a signed certificate for an LLM answer without sharing my model API key?”
“What token savings would compression have given a prompt I already ran?”
Tell an agent
Certify response {response} to prompt {prompt} for tenant {tenant_did}.
Sign my own {model} output {response} for prompt {prompt} under tenant {tenant_did}.
POST /v1/amplify/verify Verify an Amplify certificate · Amplify Verify #
Ask an LLM
“How can anyone confirm an Amplify certificate's signature is valid?”
“Can I check that a certificate binds to a specific prompt and response?”
Tell an agent
Verify certificate {payload} with signature {signature_b64} and public key {pubkey_b64}.
Check that certificate {payload} signed {signature_b64} under {pubkey_b64} matches response {response}.
POST /v1/amplify/wrap-receipt Upgrade a vertical receipt to a signed cert · Wrap Receipt #
Ask an LLM
“Can I turn an existing receipt from another vertical into a CCACW signed certificate?”
“Does wrapping a receipt change my original receipt?”
Tell an agent
Wrap receipt {receipt} from vertical {vertical} for event {event_type} with payload {payload}, tenant {tenant_did}.
Add a CCACW cert to the {vertical} receipt {receipt} for {event_type}, payload {payload}, tenant {tenant_did}.
GET /v1/amplify/selftest Self-test the Amplify pipeline · Selftest #
Ask an LLM
“Is there a way to test Amplify's compile, compress and sign steps without calling an LLM?”
“What does the Amplify self-test verify?”
Tell an agent
Run the Amplify self-test.
Check the compile-compress-sign chain is working.
GET /v1/amplify/bench Benchmark Amplify against a raw model call · Bench #
Ask an LLM
“How much does Amplify reduce tokens, latency and cost versus a plain call?”
“Can I benchmark Amplify with my own prompt and model?”
Tell an agent
Benchmark Amplify.
Benchmark prompt {prompt} on model {model} with and without Amplify.

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-amplify-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-amplify-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-amplify-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: HiveMorph v0.1 Amplify API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: amplify
paths:
  /v1/amplify/call:
    post:
      tags:
      - amplify
      summary: Call
      operationId: call_v1_amplify_call_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CallBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Call V1 Amplify Call Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/amplify/corpus/append:
    post:
      tags:
      - amplify
      summary: Corpus Append
      operationId: corpus_append_v1_amplify_corpus_append_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AppendBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Corpus Append V1 Amplify Corpus Append Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/amplify/corpus/retrieve:
    get:
      tags:
      - amplify
      summary: Corpus Retrieve
      operationId: corpus_retrieve_v1_amplify_corpus_retrieve_get
      parameters:
      - name: tenant_did
        in: query
        required: true
        schema:
          type: string
          title: Tenant Did
      - name: query
        in: query
        required: true
        schema:
          type: string
          title: Query
      - name: k
        in: query
        required: false
        schema:
          type: integer
          default: 5
          title: K
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Corpus Retrieve V1 Amplify Corpus Retrieve Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/amplify/corpus/stats:
    get:
      tags:
      - amplify
      summary: Corpus Stats
      operationId: corpus_stats_v1_amplify_corpus_stats_get
      parameters:
      - name: tenant_did
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Tenant Did
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Corpus Stats V1 Amplify Corpus Stats Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/amplify/sign:
    post:
      tags:
      - amplify
      summary: Amplify Sign
      description: 'Split mode. Customer ran the LLM on their side.

        We receive (tenant_did, prompt, response), COMPILE + COMPRESS + AMPLIFY + CERT.


        The widget transmits only the response + the raw prompt (we re-hash and

        re-compress server-side so customers see the exact token savings they would

        get if they re-issued the LLM call against the compressed prompt).


        Customer''s LLM API key never leaves their network. We bind everything into

        one ML-DSA-65 certificate.'
      operationId: amplify_sign_v1_amplify_sign_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SignBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Amplify Sign V1 Amplify Sign Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/amplify/verify:
    post:
      tags:
      - amplify
      summary: Amplify Verify
      description: 'Public verification. Anyone with the certificate can confirm:

        (a) signature is valid under our pubkey

        (b) response_sha256 + prompt_hash bind to the supplied prompt/response'
      operationId: amplify_verify_v1_amplify_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VerifyBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Amplify Verify V1 Amplify Verify Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/amplify/wrap-receipt:
    post:
      tags:
      - amplify
      summary: Wrap Receipt
      description: 'Upgrade any existing vertical receipt into a CCACW signed cert.


        Additive: the caller''s original receipt is returned unchanged; the new

        `ccacw_receipt` field is appended. No vertical needs to change its

        route shape — they call this once and re-emit the result.'
      operationId: wrap_receipt_v1_amplify_wrap_receipt_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WrapReceiptBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Wrap Receipt V1 Amplify Wrap Receipt Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/amplify/selftest:
    get:
      tags:
      - amplify
      summary: Selftest
      description: No LLM call. Verifies COMPILE → COMPRESS → SIGN locally.
      operationId: selftest_v1_amplify_selftest_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Selftest V1 Amplify Selftest Get
  /v1/amplify/bench:
    get:
      tags:
      - amplify
      summary: Bench
      description: 'Side-by-side: raw hivecompute call vs full AMPLIFY loop.

        Returns hard numbers: token reduction, latency delta, cost delta.'
      operationId: bench_v1_amplify_bench_get
      parameters:
      - name: prompt
        in: query
        required: false
        schema:
          type: string
          default: Summarize the key indemnity considerations for a SaaS vendor master agreement covering data breach, IP infringement, third-party services, and limitation of liability.
          title: Prompt
      - name: tenant_did
        in: query
        required: false
        schema:
          type: string
          default: did:hive:bench
          title: Tenant Did
      - name: model
        in: query
        required: false
        schema:
          type: string
          default: gpt-4o-mini
          title: Model
      - name: max_tokens
        in: query
        required: false
        schema:
          type: integer
          default: 256
          title: Max Tokens
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Bench V1 Amplify Bench Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    VerifyBody:
      properties:
        payload:
          additionalProperties: true
          type: object
          title: Payload
        signature_b64:
          type: string
          minLength: 8
          title: Signature B64
        pubkey_b64:
          type: string
          minLength: 8
          title: Pubkey B64
        prompt:
          anyOf:
          - type: string
          - type: 'null'
          title: Prompt
        response:
          anyOf:
          - type: string
          - type: 'null'
          title: Response
      type: object
      required:
      - payload
      - signature_b64
      - pubkey_b64
      title: VerifyBody
    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
    AppendBody:
      properties:
        tenant_did:
          type: string
          title: Tenant Did
        kind:
          type: string
          pattern: ^(response|fact|pattern)$
          title: Kind
        content:
          type: string
          maxLength: 20000
          minLength: 1
          title: Content
        meta:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Meta
      type: object
      required:
      - tenant_did
      - kind
      - content
      title: AppendBody
    WrapReceiptBody:
      properties:
        vertical:
          type: string
          maxLength: 64
          minLength: 2
          title: Vertical
          description: vertical id, e.g. lex-contract, alcoa-agentguard, hipaa-hive
        event_type:
          type: string
          maxLength: 128
          minLength: 2
          title: Event Type
          description: e.g. draft_attest, dosing_attest, consent_attest
        payload:
          additionalProperties: true
          type: object
          title: Payload
          description: the original attest input
        receipt:
          additionalProperties: true
          type: object
          title: Receipt
          description: the original attest output
        tenant_did:
          type: string
          maxLength: 256
          minLength: 3
          title: Tenant Did
        counterparty_did:
          anyOf:
          - type: string
          - type: 'null'
          title: Counterparty Did
        price_atomic:
          anyOf:
          - type: integer
          - type: 'null'
          title: Price Atomic
        partner_id:
          anyOf:
          - type: string
          - type: 'null'
          title: Partner Id
      type: object
      required:
      - vertical
      - event_type
      - payload
      - receipt
      - tenant_did
      title: WrapReceiptBody
      description: 'Universal CCACW wrapper. Lets any vertical (LEX, ALCOA, HIPAA, etc.)

        take its existing attest payload and upgrade it into a CCACW-signed

        receipt with ML-DSA-65 + partner_id attribution + dual-DID binding.


        The original attest payload is hashed into prompt_hash; the existing

        receipt is signed as the response. Verticals keep their formats and

        gain CCACW provability in one POST.'
    SignBody:
      properties:
        tenant_did:
          type: string
          maxLength: 256
          minLength: 3
          title: Tenant Did
        prompt:
          type: string
          maxLength: 64000
          minLength: 1
          title: Prompt
        response:
          type: string
          maxLength: 200000
          minLength: 1
          title: Response
        model:
          anyOf:
          - type: string
          - type: 'null'
          title: Model
        amplify:
          type: boolean
          title: Amplify
          default: true
        skip_writeback:
          type: boolean
          title: Skip Writeback
          default: false
        partner_id:
          anyOf:
          - type: string
            maxLength: 128
          - type: 'null'
          title: Partner Id
        counterparty_did:
          anyOf:
          - type: string
            maxLength: 256
          - type: 'null'
          title: Counterparty Did
        price_atomic:
          anyOf:
          - type: integer
            minimum: 0.0
          - type: 'null'
          title: Price Atomic
      type: object
      required:
      - tenant_did
      - prompt
      - response
      title: SignBody
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    CallBody:
      properties:
        prompt:
          type: string
          maxLength: 20000
          minLength: 1
          title: Prompt
        tenant_did:
          type: string
          maxLength: 256
          minLength: 3
          title: Tenant Did
        model:
          type: string
          title: Model
          default: gpt-4o-mini
        smsh_mode:
          type: string
          title: Smsh Mode
          default: smsh-std
        max_tokens:
          type: integer
          title: Max Tokens
          default: 512
        temperature:
          type: number
          title: Temperature
          default: 0.2
        skip_writeback:
          type: boolean
          title: Skip Writeback
          default: false
      type: object
      required:
      - prompt
      - tenant_did
      title: CallBody
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)