Verified Digital Agents (VDA)

Verified Digital Agents (VDA) Witness API

The Witness API from Verified Digital Agents (VDA) — 23 operation(s) for witness.

GitHub OpenAPI

Operations 23

POST /api/witness/test-key Self-serve: mint an instant SEALED-tier API key (no human in the loop) #
POST /api/witness/renew/challenge Agent-provable renewal, step 1: get a one-time challenge nonce #
POST /api/witness/renew Agent-provable renewal, step 2: prove control → fresh short-TTL key #
POST /api/witness/account/bind-controller Bind an Ed25519 controller key to an EXISTING account (upgrade to durable) #
POST /api/witness/seal Seal a governed decision into a signed, hash-chained record #
POST /api/witness/seal/hitl-decision Seal a human-in-the-loop decision (shaped — evidentiary basis required) #
POST /api/witness/seal/agent-action Seal an autonomous agent action (shaped — evidence and/or parameters) #
POST /api/witness/seal/attestation Seal an attestation (shaped — a fact/state as of a time) #
POST /api/witness/prepare Customer-managed custody: prepare a shaped body for local signing (STATELESS) #
POST /api/witness/credentials/issue Issue an agent admission credential (a sealed attestation) #
GET /api/witness/credentials/{credential_id} check_valid — is this admission credential currently valid? (PUBLIC) #
POST /api/witness/credentials/{credential_id}/revoke Revoke an admission credential (issuer account only) #
POST /api/witness/keys/revoke Revoke an account API key — sealed as a key_revocation event #
GET /api/witness/records/{recordId}/issuer verify_record_issuer — is a record's signature by the issuer it claims? #
POST /api/witness/verify Independently verify a record or chain (PUBLIC — no key) #
GET /api/witness/records list_records — read your own records (account-scoped operational query; account… #
GET /api/witness/records/{recordId} get_record — the FULL signed body of one of your records (reasoning, inputs… #
GET /api/witness/chains/{chainKey}/proof Whole-chain OFFLINE proof bundle — verify an entire trail with zero Witness… #
POST /api/witness/report Article 12 EVIDENCE report from your trail (a compliance artefact, not a query… #
GET /api/witness/usage This account's seal usage + monthly headroom (Sealed tier includes 5,000… #
GET /api/witness/whoami Resolve the presented API key to its account + tier (suite-service credential… #
GET /api/witness/anchor-status Anchor coverage for your account/chain #
POST /api/witness/mcp Model Context Protocol endpoint (initialize / tools/list / tools/call… #

Documentation

📖
Documentation
https://witness.getvda.ai/docs
📖
Documentation
https://getvda.ai/blocks/hitl.html
📖
Documentation
https://getvda.ai/blocks/acp.html
📖
Documentation
https://getvda.ai/c2md/generate-compliance-bundle.html
📖
APIReference
https://c2md.getvda.ai/docs
📖
Documentation
https://agents.getvda.ai/agents

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/openapi/getvda-ai-witness-api-openapi.yml

Other Resources

🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/llms/getvda-ai-witness-llms.txt
🔗
LLMsTxt
https://witness.getvda.ai/llms.txt
🔗
ToolCrosswalk
https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/mcp/getvda-ai-tool-crosswalk.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/data-model/getvda-ai-data-model.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/sandbox/getvda-ai-sandbox.yml
🔗
X-DID
https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/well-known/getvda-ai-witness-did.json
🔗
X-ProofOfIntegrity
https://witness.getvda.ai/proof
🔗
X-DID
https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/well-known/getvda-ai-hitl-did.json
🔗
X-DID
https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/well-known/getvda-ai-acp-did.json
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/llms/getvda-ai-c2md-llms.txt
🔗
LLMsTxt
https://c2md.getvda.ai/llms.txt
🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/scopes/getvda-ai-scopes.yml
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/llms/getvda-ai-gosce-llms.txt
🔗
LLMsTxt
https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/llms/getvda-ai-gosce-router-llms.txt
🔗
X-AgentCatalog
https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/well-known/getvda-ai-agents-ai-catalog.json
🔗
X-JWKS
https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/well-known/getvda-ai-agents-jwks.json
🔗
X-DID
https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/well-known/getvda-ai-agents-did.json
🔗
SourceCode
https://github.com/mikerawsonnz/gosce-agents

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/getvda-ai-witness-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

getvda-ai-witness-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: VDA Witness API
  version: 1.0.0
  description: Seal governed AI-agent decisions into tamper-evident, Ed25519-signed, independently-verifiable records, and verify them OFFLINE against public infrastructure (Sigstore Rekor + RFC-3161 TSAs).
  license:
    name: Apache-2.0
servers:
- url: https://witness.getvda.ai
tags:


# --- truncated at 32 KB (50 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/getvda-ai/refs/heads/main/openapi/getvda-ai-witness-api-openapi.yml