{
  "openapi": "3.1.0",
  "info": {
    "title": "WITNESS Standard — Public Discovery and Evidence Interfaces",
    "version": "0.2.0",
    "summary": "Evidence-backed creator intelligence machine surfaces.",
    "description": "Public discovery, configuration, Record verification, MCP, and A2A entry points for WITNESS Standard. This document intentionally covers discovery and interoperability surfaces rather than the complete authenticated application API.",
    "termsOfService": "https://witnessstandard.com/standard.html",
    "contact": {
      "name": "WITNESS Standard",
      "url": "https://witnessstandard.com/developers.html"
    }
  },
  "servers": [
    {
      "url": "https://chat.witnessstandard.com",
      "description": "WITNESS production application and machine-interface origin"
    }
  ],
  "tags": [
    {"name":"Discovery","description":"Public WITNESS machine discovery surfaces."},
    {"name":"Public configuration","description":"Public service health and capability metadata."},
    {"name":"Records","description":"Public governed Record retrieval and verification surfaces."},
    {"name":"MCP","description":"Model Context Protocol entry point for authenticated compatible clients."},
    {"name":"A2A","description":"Agent-to-Agent v1 discovery and authenticated message transport."}
  ],
  "paths": {
    "/v1/health": {
      "get": {
        "tags": ["Public configuration"],
        "summary": "Read WITNESS service health",
        "operationId": "getWitnessHealth",
        "responses": {"200":{"description":"Service health response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}
      }
    },
    "/v1/config": {
      "get": {
        "tags": ["Public configuration"],
        "summary": "Read public WITNESS configuration",
        "operationId": "getWitnessPublicConfig",
        "responses": {"200":{"description":"Public configuration","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}
      }
    },
    "/v1/capabilities": {
      "get": {
        "tags": ["Public configuration"],
        "summary": "Read public WITNESS application capabilities",
        "operationId": "getWitnessCapabilities",
        "responses": {"200":{"description":"Capability metadata","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}
      }
    },
    "/.well-known/mcp.json": {
      "get": {
        "tags": ["Discovery", "MCP"],
        "summary": "Discover the WITNESS MCP endpoint",
        "operationId": "discoverWitnessMcp",
        "responses": {"200":{"description":"MCP discovery document","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}
      }
    },
    "/mcp": {
      "post": {
        "tags": ["MCP"],
        "summary": "Use the authenticated WITNESS MCP transport",
        "operationId": "witnessMcp",
        "security": [{"bearerAuth":[]}],
        "requestBody": {"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},
        "responses": {
          "200":{"description":"MCP response"},
          "401":{"description":"Authentication required"}
        }
      }
    },
    "/.well-known/agent-card.json": {
      "get": {
        "tags": ["Discovery", "A2A"],
        "summary": "Discover the WITNESS A2A v1 Agent Card",
        "operationId": "discoverWitnessA2aAgent",
        "parameters": [{"name":"If-None-Match","in":"header","required":false,"schema":{"type":"string"},"description":"Version-bound Agent Card ETag for conditional discovery."}],
        "responses": {
          "200":{"description":"A2A Agent Card","headers":{"ETag":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},
          "304":{"description":"Agent Card has not changed"}
        }
      }
    },
    "/a2a/extensions/witness-evidence/v1": {
      "get": {
        "tags": ["Discovery", "A2A"],
        "summary": "Read the WITNESS A2A evidence-extension contract",
        "operationId": "getWitnessA2aEvidenceExtension",
        "responses": {"200":{"description":"WITNESS evidence extension","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}
      }
    },
    "/a2a/v1/message:send": {
      "post": {
        "tags": ["A2A"],
        "summary": "Send an authenticated A2A v1 message to WITNESS",
        "operationId": "sendWitnessA2aMessage",
        "security": [{"bearerAuth":[]}],
        "parameters": [
          {"name":"A2A-Version","in":"header","required":true,"schema":{"type":"string","const":"1.0"}},
          {"name":"A2A-Extensions","in":"header","required":false,"schema":{"type":"string"}}
        ],
        "requestBody": {"required":true,"content":{"application/a2a+json":{"schema":{"type":"object","additionalProperties":true}}}},
        "responses": {
          "200":{"description":"A2A task result","content":{"application/a2a+json":{"schema":{"type":"object","additionalProperties":true}}}},
          "401":{"description":"Authentication required"}
        }
      }
    },
    "/records/{recordId}": {
      "get": {
        "tags": ["Records"],
        "summary": "Read a public WITNESS Record artifact",
        "operationId": "getPublicWitnessRecord",
        "parameters": [{"name":"recordId","in":"path","required":true,"schema":{"type":"string"}}],
        "responses": {
          "200":{"description":"Canonical public Record artifact","headers":{"ETag":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},
          "404":{"description":"Record not found"}
        }
      }
    },
    "/v1/records/{recordId}/verification": {
      "get": {
        "tags": ["Records"],
        "summary": "Verify a public WITNESS Record",
        "operationId": "verifyPublicWitnessRecord",
        "parameters": [{"name":"recordId","in":"path","required":true,"schema":{"type":"string"}}],
        "responses": {
          "200":{"description":"Record verification result","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},
          "404":{"description":"Record not found"}
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "WITNESS authenticated access token",
        "description": "Use an authenticated WITNESS bearer token for private MCP and A2A interactions."
      }
    }
  },
  "externalDocs": {
    "description": "WITNESS developer and evidence-interface documentation",
    "url": "https://witnessstandard.com/developers.html"
  }
}