Hive Civilization

Hive Civilization Alcoa Agentguard API

The alcoa-agentguard API from Hive Civilization — 11 operation(s) for alcoa-agentguard.

GitHub OpenAPI

Operations 11

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/alcoa-agentguard/health Check ALCOA AgentGuard service health · Health #
Ask an LLM
“Is the clinical-trial ALCOA attestation service running?”
“Can I health-check AgentGuard before recording trial events?”
Tell an agent
Check the health of the ALCOA AgentGuard service.
Ping AgentGuard to see if it's up.
GET /v1/alcoa-agentguard/pricing See ALCOA AgentGuard pricing · Pricing #
Ask an LLM
“How much does it cost to attest clinical trial events?”
“What is the price per AgentGuard receipt?”
Tell an agent
Show me ALCOA AgentGuard pricing.
Get the price list for clinical trial attestations.
POST /v1/alcoa-agentguard/protocol_attest Record a trial protocol or amendment event · Protocol Attest #
Ask an LLM
“How do I create a tamper-evident record of a trial protocol amendment?”
“Can I attest a new study protocol version for a clinical trial?”
Tell an agent
Attest a protocol event for trial {trial_id} by {attributable_did} with payload hash {original_payload_hash}.
Record protocol amendment {event_payload} on trial {trial_id}, attributed to {attributable_did}, hash {original_payload_hash}.
POST /v1/alcoa-agentguard/consent_attest Record a patient consent event · Consent Attest #
Ask an LLM
“How do I prove which IRB-approved consent form a patient signed?”
“Can I attest patient informed consent with the IRB version hash?”
Tell an agent
Attest patient consent for trial {trial_id} by {attributable_did} under IRB version {irb_version_hash}, payload hash {original_payload_hash}.
Record a consent signature on {trial_id} against IRB form {irb_version_hash} (hash {original_payload_hash}, by {attributable_did}).
POST /v1/alcoa-agentguard/enrollment_attest Record a trial enrollment event · Enrollment Attest #
Ask an LLM
“How do I log a subject enrolling in a clinical trial with a signed receipt?”
“Can enrollment events be attributed to the site agent that recorded them?”
Tell an agent
Attest an enrollment in trial {trial_id} by {attributable_did} with payload hash {original_payload_hash}.
Record subject enrollment {event_payload} for trial {trial_id} (hash {original_payload_hash}, by {attributable_did}).
POST /v1/alcoa-agentguard/dosing_attest Record a trial dosing event · Dosing Attest #
Ask an LLM
“How do I create an ALCOA-compliant record that a study dose was administered?”
“Can I attest each dosing event in a trial?”
Tell an agent
Attest a dosing event for trial {trial_id} by {attributable_did}, payload hash {original_payload_hash}.
Record dose administration {event_payload} on trial {trial_id} with hash {original_payload_hash} by {attributable_did}.
POST /v1/alcoa-agentguard/adverse_event_attest Record an adverse event, SAE or SUSAR · Adverse Event Attest #
Ask an LLM
“How do I log a serious adverse event in a trial with a signed receipt?”
“Can I classify the attested event as an AE, SAE or SUSAR?”
Tell an agent
Attest an adverse event of type {ae_type} for trial {trial_id} by {attributable_did}, hash {original_payload_hash}.
Record a safety event on trial {trial_id} with payload hash {original_payload_hash}, reported by {attributable_did}.
POST /v1/alcoa-agentguard/data_transfer_attest Record a trial data handoff to a CRO · Data Transfer Attest #
Ask an LLM
“How do I prove trial data was handed off to a CRO and to whom?”
“Can I attest a data transfer with the recipient's DID?”
Tell an agent
Attest a data transfer on trial {trial_id} from {attributable_did} to {recipient_did}, hash {original_payload_hash}.
Record handing off trial {trial_id} data to CRO {recipient_did} (hash {original_payload_hash}, sender {attributable_did}).
POST /v1/alcoa-agentguard/database_lock_attest Record a trial database lock · Database Lock Attest #
Ask an LLM
“How do I attest that a clinical trial database was locked?”
“Can a database lock be recorded with a hash of the locked data?”
Tell an agent
Attest the database lock for trial {trial_id} by {attributable_did} with hash {original_payload_hash}.
Record that trial {trial_id}'s database is locked, snapshot hash {original_payload_hash}, signed off by {attributable_did}.
GET /v1/alcoa-agentguard/chain_verify Verify a trial's receipt chain · Chain Verify Endpoint #
Ask an LLM
“How do I check that every attested event for a trial is intact and correctly signed?”
“Can I get the ordered chain of receipts for a clinical trial?”
Tell an agent
Verify the receipt chain for trial {trial_id}.
Show the ordered signed events for trial {trial_id} and whether the chain is valid.
GET /v1/alcoa-agentguard/alcoa_audit Score a trial's ALCOA+ completeness · Alcoa Audit Endpoint #
Ask an LLM
“How complete are a trial's records against the nine ALCOA+ attributes?”
“Which receipts in my trial fail ALCOA+ checks?”
Tell an agent
Run an ALCOA+ audit for trial {trial_id}.
Give me the ALCOA+ completeness report for {trial_id}.

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-alcoa-agentguard-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-alcoa-agentguard-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-alcoa-agentguard-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: HiveMorph v0.1 Alcoa Agentguard API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: alcoa-agentguard
paths:
  /v1/alcoa-agentguard/health:
    get:
      tags:
      - alcoa-agentguard
      summary: Health
      operationId: health_v1_alcoa_agentguard_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Health V1 Alcoa Agentguard Health Get
  /v1/alcoa-agentguard/pricing:
    get:
      tags:
      - alcoa-agentguard
      summary: Pricing
      operationId: pricing_v1_alcoa_agentguard_pricing_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Pricing V1 Alcoa Agentguard Pricing Get
  /v1/alcoa-agentguard/protocol_attest:
    post:
      tags:
      - alcoa-agentguard
      summary: Protocol Attest
      description: Record a protocol or amendment event.
      operationId: protocol_attest_v1_alcoa_agentguard_protocol_attest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProtocolAttestRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Protocol Attest V1 Alcoa Agentguard Protocol Attest Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/alcoa-agentguard/consent_attest:
    post:
      tags:
      - alcoa-agentguard
      summary: Consent Attest
      description: Record a patient consent event (with IRB version hash).
      operationId: consent_attest_v1_alcoa_agentguard_consent_attest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConsentAttestRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Consent Attest V1 Alcoa Agentguard Consent Attest Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/alcoa-agentguard/enrollment_attest:
    post:
      tags:
      - alcoa-agentguard
      summary: Enrollment Attest
      description: Record an enrollment event.
      operationId: enrollment_attest_v1_alcoa_agentguard_enrollment_attest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EnrollmentAttestRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Enrollment Attest V1 Alcoa Agentguard Enrollment Attest Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/alcoa-agentguard/dosing_attest:
    post:
      tags:
      - alcoa-agentguard
      summary: Dosing Attest
      description: Record a dosing event.
      operationId: dosing_attest_v1_alcoa_agentguard_dosing_attest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DosingAttestRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Dosing Attest V1 Alcoa Agentguard Dosing Attest Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/alcoa-agentguard/adverse_event_attest:
    post:
      tags:
      - alcoa-agentguard
      summary: Adverse Event Attest
      description: Record an adverse event, SAE, or SUSAR.
      operationId: adverse_event_attest_v1_alcoa_agentguard_adverse_event_attest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdverseEventAttestRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Adverse Event Attest V1 Alcoa Agentguard Adverse Event Attest Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/alcoa-agentguard/data_transfer_attest:
    post:
      tags:
      - alcoa-agentguard
      summary: Data Transfer Attest
      description: Record a CRO data handoff / transfer event.
      operationId: data_transfer_attest_v1_alcoa_agentguard_data_transfer_attest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DataTransferAttestRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Data Transfer Attest V1 Alcoa Agentguard Data Transfer Attest Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/alcoa-agentguard/database_lock_attest:
    post:
      tags:
      - alcoa-agentguard
      summary: Database Lock Attest
      description: Record a database lock event.
      operationId: database_lock_attest_v1_alcoa_agentguard_database_lock_attest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DatabaseLockAttestRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Database Lock Attest V1 Alcoa Agentguard Database Lock Attest Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/alcoa-agentguard/chain_verify:
    get:
      tags:
      - alcoa-agentguard
      summary: Chain Verify Endpoint
      description: Return ordered receipt chain + chain_valid bool + per-receipt sig validity.
      operationId: chain_verify_endpoint_v1_alcoa_agentguard_chain_verify_get
      parameters:
      - name: trial_id
        in: query
        required: true
        schema:
          type: string
          description: Trial ID to verify chain for
          title: Trial Id
        description: Trial ID to verify chain for
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Chain Verify Endpoint V1 Alcoa Agentguard Chain Verify Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/alcoa-agentguard/alcoa_audit:
    get:
      tags:
      - alcoa-agentguard
      summary: Alcoa Audit Endpoint
      description: Return ALCOA+ completeness report — 9 attributes scored 0/1 per receipt + trial-level summary.
      operationId: alcoa_audit_endpoint_v1_alcoa_agentguard_alcoa_audit_get
      parameters:
      - name: trial_id
        in: query
        required: true
        schema:
          type: string
          description: Trial ID to audit ALCOA+ completeness for
          title: Trial Id
        description: Trial ID to audit ALCOA+ completeness for
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Alcoa Audit Endpoint V1 Alcoa Agentguard Alcoa Audit Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    EnrollmentAttestRequest:
      properties:
        trial_id:
          type: string
          title: Trial Id
          description: Unique trial identifier
        attributable_did:
          type: string
          title: Attributable Did
          description: DID of site or investigator
        legible_format:
          type: string
          title: Legible Format
          description: Data format
          default: CDISC-SDTM/DM
        original_payload_hash:
          type: string
          title: Original Payload Hash
          description: sha256 of enrollment record
        consistent_schema:
          type: string
          title: Consistent Schema
          description: Schema URI/version
          default: CDISC-SDTM-v3.3/DM
        event_payload:
          additionalProperties: true
          type: object
          title: Event Payload
          description: 'Enrollment metadata: subject_id, arm, randomization_code, etc.'
      type: object
      required:
      - trial_id
      - attributable_did
      - original_payload_hash
      title: EnrollmentAttestRequest
      description: Record an enrollment event.
    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
    ConsentAttestRequest:
      properties:
        trial_id:
          type: string
          title: Trial Id
          description: Unique trial identifier
        attributable_did:
          type: string
          title: Attributable Did
          description: DID of patient or site
        irb_version_hash:
          type: string
          title: Irb Version Hash
          description: sha256 of IRB-approved consent form version
        legible_format:
          type: string
          title: Legible Format
          description: Data format
          default: FHIR-R5/Consent
        original_payload_hash:
          type: string
          title: Original Payload Hash
          description: sha256 of consent document
        consistent_schema:
          type: string
          title: Consistent Schema
          description: Schema URI/version
          default: FHIR-R5-Consent
        event_payload:
          additionalProperties: true
          type: object
          title: Event Payload
          description: 'Consent metadata: patient_id, irb_number, consent_date, etc.'
      type: object
      required:
      - trial_id
      - attributable_did
      - irb_version_hash
      - original_payload_hash
      title: ConsentAttestRequest
      description: Record a patient consent event (with IRB version hash).
    DosingAttestRequest:
      properties:
        trial_id:
          type: string
          title: Trial Id
          description: Unique trial identifier
        attributable_did:
          type: string
          title: Attributable Did
          description: DID of site or nurse administering
        legible_format:
          type: string
          title: Legible Format
          description: Data format
          default: CDISC-SDTM/EX
        original_payload_hash:
          type: string
          title: Original Payload Hash
          description: sha256 of dosing record
        consistent_schema:
          type: string
          title: Consistent Schema
          description: Schema URI/version
          default: CDISC-SDTM-v3.3/EX
        event_payload:
          additionalProperties: true
          type: object
          title: Event Payload
          description: 'Dosing metadata: subject_id, dose_mg, route, datetime, batch_number, etc.'
      type: object
      required:
      - trial_id
      - attributable_did
      - original_payload_hash
      title: DosingAttestRequest
      description: Record a dosing event.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    DatabaseLockAttestRequest:
      properties:
        trial_id:
          type: string
          title: Trial Id
          description: Unique trial identifier
        attributable_did:
          type: string
          title: Attributable Did
          description: DID of data manager or sponsor
        legible_format:
          type: string
          title: Legible Format
          description: Data format
          default: CDISC-SDTM
        original_payload_hash:
          type: string
          title: Original Payload Hash
          description: sha256 of locked database snapshot
        consistent_schema:
          type: string
          title: Consistent Schema
          description: Schema URI/version
          default: CDISC-SDTM-v3.3
        event_payload:
          additionalProperties: true
          type: object
          title: Event Payload
          description: 'Lock metadata: lock_date, locked_by_did, dataset_version, query_count_resolved, etc.'
      type: object
      required:
      - trial_id
      - attributable_did
      - original_payload_hash
      title: DatabaseLockAttestRequest
      description: Record a database lock event.
    AdverseEventAttestRequest:
      properties:
        trial_id:
          type: string
          title: Trial Id
          description: Unique trial identifier
        attributable_did:
          type: string
          title: Attributable Did
          description: DID of investigator or site
        ae_type:
          type: string
          title: Ae Type
          description: AE / SAE / SUSAR
          default: AE
        legible_format:
          type: string
          title: Legible Format
          description: Data format
          default: CDISC-SDTM/AE
        original_payload_hash:
          type: string
          title: Original Payload Hash
          description: sha256 of AE record
        consistent_schema:
          type: string
          title: Consistent Schema
          description: Schema URI/version
          default: CDISC-SDTM-v3.3/AE
        event_payload:
          additionalProperties: true
          type: object
          title: Event Payload
          description: 'AE metadata: subject_id, meddra_code, severity, seriousness, relatedness, onset_date, etc.'
      type: object
      required:
      - trial_id
      - attributable_did
      - original_payload_hash
      title: AdverseEventAttestRequest
      description: Record an adverse event, SAE, or SUSAR.
    DataTransferAttestRequest:
      properties:
        trial_id:
          type: string
          title: Trial Id
          description: Unique trial identifier
        attributable_did:
          type: string
          title: Attributable Did
          description: DID of sender (sponsor/site)
        recipient_did:
          type: string
          title: Recipient Did
          description: DID of recipient (CRO)
        legible_format:
          type: string
          title: Legible Format
          description: Data format
          default: CDISC-SDTM
        original_payload_hash:
          type: string
          title: Original Payload Hash
          description: sha256 of transferred dataset
        consistent_schema:
          type: string
          title: Consistent Schema
          description: Schema URI/version
          default: CDISC-SDTM-v3.3
        event_payload:
          additionalProperties: true
          type: object
          title: Event Payload
          description: 'Transfer metadata: dataset_name, record_count, transfer_method, checksum, etc.'
      type: object
      required:
      - trial_id
      - attributable_did
      - recipient_did
      - original_payload_hash
      title: DataTransferAttestRequest
      description: Record a CRO data handoff / transfer event.
    ProtocolAttestRequest:
      properties:
        trial_id:
          type: string
          title: Trial Id
          description: Unique trial identifier
        attributable_did:
          type: string
          title: Attributable Did
          description: DID of protocol author/sponsor
        legible_format:
          type: string
          title: Legible Format
          description: Data format
          default: JSON-LD/CDISC-SDTM
        original_payload_hash:
          type: string
          title: Original Payload Hash
          description: sha256 of protocol document
        consistent_schema:
          type: string
          title: Consistent Schema
          description: Schema URI/version
          default: CDISC-SDTM-v3.3
        event_payload:
          additionalProperties: true
          type: object
          title: Event Payload
          description: 'Protocol metadata: title, version, amendment_number, etc.'
      type: object
      required:
      - trial_id
      - attributable_did
      - original_payload_hash
      title: ProtocolAttestRequest
      description: Record a protocol or amendment event.
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)