Hive Civilization Morso API

The morso API from Hive Civilization — 6 operation(s) for morso.

Operations 6

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/morso/health Check the MORSO service health · Morso Health #
Ask an LLM
“Is the MORSO excerpt receipt service up?”
“Can I ping MORSO before issuing excerpt receipts?”
Tell an agent
Check MORSO health.
Confirm the MORSO service is responding.
POST /v1/morso/issue Issue a MORSO excerpt from a sealed parent · Morso Issue #
Ask an LLM
“How do I issue a MORSO for an excerpt taken from a sealed parent document?”
“Can I supply my own excerpt commitment when issuing a MORSO?”
Tell an agent
Issue a MORSO for excerpt "{excerpt}" from parent {parent_mor} sealed as {sealed_parent}.
Issue excerpt {excerpt} under parent MOR {parent_mor} and sealed parent {sealed_parent} with commitment {excerpt_commitment}.
POST /v1/morso/receipt Get a signed receipt for an excerpt · Morso Receipt #
Ask an LLM
“How do I get a signed MORSO receipt proving an excerpt came from its parent?”
“What goes into a signed excerpt receipt request?”
Tell an agent
Create a signed MORSO receipt for excerpt "{excerpt}" of parent {parent_mor}, sealed {sealed_parent}.
Receipt excerpt {excerpt} against sealed parent {sealed_parent} and MOR {parent_mor}.
POST /v1/morso/verify Verify a MORSO receipt · Morso Verify #
Ask an LLM
“Is this MORSO excerpt receipt genuine?”
“Can I check a MORSO receipt's signature?”
Tell an agent
Verify MORSO receipt {receipt}.
Check the signature on excerpt receipt {receipt}.
POST /v1/morso/classify Preview how an excerpt would be classified · Morso Classify #
Ask an LLM
“Can I see how an excerpt would be classified without getting a signed receipt?”
“What classification would MORSO give this excerpt?”
Tell an agent
Classify excerpt "{excerpt}" from sealed parent {sealed_parent} as a preview.
Preview the classification of {excerpt} against {sealed_parent} without signing.
GET /v1/morso/examples Get example MORSO payloads · Morso Examples #
Ask an LLM
“Are there sample requests I can copy for MORSO?”
“What do MORSO example payloads look like?”
Tell an agent
Show MORSO examples.
Get sample MORSO requests to start from.

Documentation

Specifications

Other Resources

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-morso-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.

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

OpenAPI Specification

thehiveryiq-com-morso-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: HiveMorph v0.1 Morso API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: morso
paths:
  /v1/morso/health:
    get:
      tags:
      - morso
      summary: Morso Health
      operationId: morso_health_v1_morso_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Morso Health V1 Morso Health Get
  /v1/morso/issue:
    post:
      tags:
      - morso
      summary: Morso Issue
      operationId: morso_issue_v1_morso_issue_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IssueRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Morso Issue V1 Morso Issue Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/morso/receipt:
    post:
      tags:
      - morso
      summary: Morso Receipt
      operationId: morso_receipt_v1_morso_receipt_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IssueRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Morso Receipt V1 Morso Receipt Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/morso/verify:
    post:
      tags:
      - morso
      summary: Morso Verify
      operationId: morso_verify_v1_morso_verify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hivemorph__hive_morso__routes__VerifyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Morso Verify V1 Morso Verify Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/morso/classify:
    post:
      tags:
      - morso
      summary: Morso Classify
      description: Classify an excerpt without issuing a signed receipt (preview only).
      operationId: morso_classify_v1_morso_classify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hivemorph__hive_morso__routes__ClassifyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Morso Classify V1 Morso Classify Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/morso/examples:
    get:
      tags:
      - morso
      summary: Morso Examples
      operationId: morso_examples_v1_morso_examples_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Morso Examples V1 Morso Examples Get
components:
  schemas:
    ExcerptIn:
      properties:
        fragments:
          items:
            $ref: '#/components/schemas/FragmentIn'
          type: array
          title: Fragments
          description: Excerpt fragments cut from the parent
        enclosing:
          anyOf:
          - $ref: '#/components/schemas/EnclosingIn'
          - type: 'null'
          description: Optional enclosing-container context
      type: object
      title: ExcerptIn
    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
    hivemorph__hive_morso__routes__VerifyRequest:
      properties:
        receipt:
          additionalProperties: true
          type: object
          title: Receipt
          description: A full MoRSo receipt object
      type: object
      required:
      - receipt
      title: VerifyRequest
    EnclosingIn:
      properties:
        units:
          anyOf:
          - type: integer
          - type: 'null'
          title: Units
          description: Total units in the enclosing container
        covered_units:
          anyOf:
          - type: integer
          - type: 'null'
          title: Covered Units
          description: Units the excerpt covers
        unit:
          type: string
          title: Unit
          default: units
        container:
          type: string
          title: Container
          default: record
        contiguous:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Contiguous
      type: object
      title: EnclosingIn
    SealedParentIn:
      properties:
        content_commitment:
          type: string
          title: Content Commitment
          description: Fingerprint of the parent media (Hive never sees content)
          default: ''
        boundaries:
          items:
            $ref: '#/components/schemas/BoundaryIn'
          type: array
          title: Boundaries
          description: Boundary map sealed at capture
        origin_attestation:
          type: string
          title: Origin Attestation
          description: Origin attestation string sealed at capture
          default: ''
        capture_meta:
          type: string
          title: Capture Meta
          description: Capture metadata sealed at capture
          default: ''
        extent:
          type: number
          title: Extent
          description: Total extent (seconds/units) of the parent
          default: 0
      type: object
      title: SealedParentIn
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    BoundaryIn:
      properties:
        kind:
          type: string
          title: Kind
          description: Boundary kind, e.g. answer_start, answer_end, question_start
        pos:
          type: number
          title: Pos
          description: Boundary position on the sealed source timeline
      type: object
      required:
      - kind
      - pos
      title: BoundaryIn
    IssueRequest:
      properties:
        parent_mor:
          additionalProperties: true
          type: object
          title: Parent Mor
          description: A full, valid parent Media Origin Receipt object
        sealed_parent:
          $ref: '#/components/schemas/SealedParentIn'
          description: The parent boundary map sealed at capture
        excerpt:
          $ref: '#/components/schemas/ExcerptIn'
          description: The excerpt to classify against the sealed boundaries
        excerpt_commitment:
          type: string
          title: Excerpt Commitment
          description: Optional fingerprint of the excerpt
          default: ''
      type: object
      required:
      - parent_mor
      - sealed_parent
      - excerpt
      title: IssueRequest
    hivemorph__hive_morso__routes__ClassifyRequest:
      properties:
        sealed_parent:
          $ref: '#/components/schemas/SealedParentIn'
        excerpt:
          $ref: '#/components/schemas/ExcerptIn'
      type: object
      required:
      - sealed_parent
      - excerpt
      title: ClassifyRequest
    FragmentIn:
      properties:
        start:
          type: number
          title: Start
          description: Fragment start on the parent timeline
        end:
          type: number
          title: End
          description: Fragment end on the parent timeline
        order:
          type: integer
          title: Order
          description: Presentation order of this fragment in the excerpt
          default: 0
      type: object
      required:
      - start
      - end
      title: FragmentIn
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)