Hive Civilization R8 Checkpoints API

The r8-checkpoints API from Hive Civilization — 7 operation(s) for r8-checkpoints.

Operations 7

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/checkpoint/policy Get the workflow checkpoint policy · Checkpoint Policy #
Ask an LLM
“What rules apply to agent workflow checkpoints?”
“Where is the checkpoint policy?”
Tell an agent
Show the checkpoint policy.
Get the rules for writing workflow checkpoints.
POST /v1/checkpoint/write Write an agent workflow checkpoint · Checkpoint Write #
Ask an LLM
“How do I save a checkpoint for an agent at a given workflow phase?”
“Can a checkpoint reference receipts, artifacts and a delegation?”
Tell an agent
Write a {phase} checkpoint for agent {agent_did} under operator {operator_did}.
Checkpoint workflow {wid} at phase {phase} for {agent_did} run by {operator_did} with state {state}.
GET /v1/checkpoint/list List workflow checkpoints · Checkpoint List #
Ask an LLM
“Which checkpoints exist for an agent or workflow?”
“Can I filter checkpoints by phase?”
Tell an agent
List checkpoints for agent {agent_did}.
Show {limit} checkpoints in phase {phase} for workflow {wid}.
GET /v1/checkpoint/workflow/{wid} Get a workflow's checkpoints · Checkpoint Workflow #
Ask an LLM
“What is the current checkpoint state of a workflow?”
“Can I pull everything recorded for one workflow id?”
Tell an agent
Get workflow {wid} checkpoints.
Show the checkpoint record for workflow {wid}.
POST /v1/checkpoint/archive/{wid} Archive a workflow's checkpoints · Checkpoint Archive #
Ask an LLM
“Can I archive a finished workflow's checkpoints?”
“What happens to a workflow once it is archived?”
Tell an agent
Archive workflow {wid}.
Close out and archive checkpoints for {wid}.
GET /v1/checkpoint/replay/{wid} Replay a workflow from its checkpoints · Checkpoint Replay #
Ask an LLM
“Can I replay a workflow's checkpoints in order?”
“Is there a way to reconstruct how a workflow progressed?”
Tell an agent
Replay workflow {wid}.
Reconstruct the phase sequence of {wid}.
GET /v1/checkpoint/{cid} Get a single checkpoint · Checkpoint Get #
Ask an LLM
“Can I fetch one checkpoint by its checkpoint id?”
“What was recorded in a specific checkpoint?”
Tell an agent
Get checkpoint {cid}.
Show the contents of checkpoint {cid}.

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-r8-checkpoints-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-r8-checkpoints-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: HiveMorph v0.1 R8 Checkpoints API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: r8-checkpoints
paths:
  /v1/checkpoint/policy:
    get:
      tags:
      - r8-checkpoints
      summary: Checkpoint Policy
      operationId: checkpoint_policy_v1_checkpoint_policy_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /v1/checkpoint/write:
    post:
      tags:
      - r8-checkpoints
      summary: Checkpoint Write
      operationId: checkpoint_write_v1_checkpoint_write_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hivemorph__hive_r8__routes__WriteReq'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/checkpoint/list:
    get:
      tags:
      - r8-checkpoints
      summary: Checkpoint List
      operationId: checkpoint_list_v1_checkpoint_list_get
      parameters:
      - name: wid
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            maxLength: 64
          - type: 'null'
          title: Wid
      - name: agent_did
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          title: Agent Did
      - name: phase
        in: query
        required: false
        schema:
          anyOf:
          - type: string
            maxLength: 40
          - type: 'null'
          title: Phase
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 1000
          minimum: 1
          default: 50
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/checkpoint/workflow/{wid}:
    get:
      tags:
      - r8-checkpoints
      summary: Checkpoint Workflow
      operationId: checkpoint_workflow_v1_checkpoint_workflow__wid__get
      parameters:
      - name: wid
        in: path
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 64
          title: Wid
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/checkpoint/archive/{wid}:
    post:
      tags:
      - r8-checkpoints
      summary: Checkpoint Archive
      operationId: checkpoint_archive_v1_checkpoint_archive__wid__post
      parameters:
      - name: wid
        in: path
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 64
          title: Wid
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/checkpoint/replay/{wid}:
    get:
      tags:
      - r8-checkpoints
      summary: Checkpoint Replay
      operationId: checkpoint_replay_v1_checkpoint_replay__wid__get
      parameters:
      - name: wid
        in: path
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 64
          title: Wid
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/checkpoint/{cid}:
    get:
      tags:
      - r8-checkpoints
      summary: Checkpoint Get
      operationId: checkpoint_get_v1_checkpoint__cid__get
      parameters:
      - name: cid
        in: path
        required: true
        schema:
          type: string
          minLength: 1
          maxLength: 64
          title: Cid
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    hivemorph__hive_r8__routes__WriteReq:
      properties:
        wid:
          anyOf:
          - type: string
            maxLength: 64
          - type: 'null'
          title: Wid
        phase:
          type: string
          maxLength: 40
          minLength: 1
          title: Phase
        agent_did:
          type: string
          maxLength: 200
          minLength: 3
          title: Agent Did
        operator_did:
          type: string
          maxLength: 200
          minLength: 3
          title: Operator Did
        state:
          additionalProperties: true
          type: object
          title: State
        rubric_hash:
          anyOf:
          - type: string
            maxLength: 128
          - type: 'null'
          title: Rubric Hash
        policy_version:
          anyOf:
          - type: string
            maxLength: 64
          - type: 'null'
          title: Policy Version
        delegation_jti:
          anyOf:
          - type: string
            maxLength: 64
          - type: 'null'
          title: Delegation Jti
        hktn_refs:
          items:
            type: string
          type: array
          maxItems: 64
          title: Hktn Refs
        receipt_refs:
          items:
            type: string
          type: array
          maxItems: 64
          title: Receipt Refs
        artifact_refs:
          items:
            type: string
          type: array
          maxItems: 64
          title: Artifact Refs
        note:
          anyOf:
          - type: string
            maxLength: 512
          - type: 'null'
          title: Note
      type: object
      required:
      - phase
      - agent_did
      - operator_did
      title: WriteReq
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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
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)