Hive Civilization Github App API

The github-app API from Hive Civilization — 3 operation(s) for github-app.

Documentation GitHub OpenAPI

Operations 3

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/github/health Check the GitHub signing app health · Health #

Ask an LLM

“Is the GitHub PR-signing app service up?”

“Can I health-check the GitHub integration?”

Tell an agent

Check the GitHub app service health.

Ping the PR-signing integration.

POST /v1/github/sign-diff Sign a pull request diff · Sign Diff Route #

Ask an LLM

“How do I post-quantum sign a pull request diff from my CI pipeline?”

“Can I sign a PR diff without installing the GitHub App?”

Tell an agent

Sign the diff {diff} for PR {pr_number} in {repo}.

Sign PR {pr_number} on {repo} from {base_sha} to {head_sha} with diff {diff}.

POST /v1/github/webhook Receive GitHub pull request webhooks · Github Webhook #

Ask an LLM

“Which pull request events does the app's webhook handle?”

“Where should GitHub deliver pull_request events so diffs get signed automatically?”

Tell an agent

Deliver this pull_request webhook event to the signing app.

Send an opened PR event to the GitHub webhook receiver.

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-github-app-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

openapi: 3.2.0
info:
  title: HiveMorph v0.1 Github App API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: github-app
paths:
  /v1/github/health:
    get:
      tags:
      - github-app
      summary: Health
      operationId: health_v1_github_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Health V1 Github Health Get
  /v1/github/sign-diff:
    post:
      tags:
      - github-app
      summary: Sign Diff Route
      description: 'Manual signing API — no GitHub App install needed.


        Useful for CI pipelines that want to PQ-sign the PR diff and post the

        receipt URL into their own checks/status. Rate-limited on the underlying

        /v1/receipt/free path semantics already.'
      operationId: sign_diff_route_v1_github_sign_diff_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SignDiffRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Sign Diff Route V1 Github Sign Diff Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/github/webhook:
    post:
      tags:
      - github-app
      summary: Github Webhook
      description: 'GitHub App webhook receiver.


        Currently handles `pull_request` events with action in {opened, synchronize,

        reopened}. We verify the X-Hub-Signature-256 header, extract the PR diff

        URL, sign the diff via the swarm receipt issuer, and (in v0.1) return the

        comment payload. v0.2 will POST the comment to the PR via the GitHub API

        using an installation access token.'
      operationId: github_webhook_v1_github_webhook_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Github Webhook V1 Github Webhook Post
components:
  schemas:
    SignDiffRequest:
      properties:
        repo:
          type: string
          maxLength: 120
          minLength: 3
          title: Repo
          description: owner/repo, e.g. 'srotzin/hivemorph'
        pr_number:
          type: integer
          minimum: 0.0
          title: Pr Number
          description: 0 if signing a non-PR diff
        diff:
          type: string
          maxLength: 200000
          minLength: 1
          title: Diff
          description: The unified diff content (max 200k chars)
        base_sha:
          anyOf:
          - type: string
            maxLength: 64
          - type: 'null'
          title: Base Sha
          description: Base commit sha
        head_sha:
          anyOf:
          - type: string
            maxLength: 64
          - type: 'null'
          title: Head Sha
          description: Head commit sha
      type: object
      required:
      - repo
      - pr_number
      - diff
      title: SignDiffRequest
    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)

Hive Civilization Github App API

Operations 3

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification