{"openapi":"3.1.0","info":{"title":"InterAI Risk Oracle","version":"0.0.1","description":"Autonomous Execution Gateway for pre-execution verification of autonomous agents.","x-trust-signing-enabled":true},"servers":[{"url":"https://ai-risk-oracle.fly.dev"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"},"AdminToken":{"type":"apiKey","in":"header","name":"X-Admin-Token"}},"schemas":{"ErrorResponse":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}},"LegacyVerifyRequest":{"type":"object","additionalProperties":false,"properties":{"prompt":{"type":"string"},"response":{"type":"string"},"domain":{"type":"string","default":"general"},"mode":{"type":"string","enum":["fast_heuristic","semantic_judge"],"default":"fast_heuristic"}},"required":["prompt","response"]},"AutonomousExecutionRequest":{"type":"object","description":"Primary autonomous_execution contract for pre-execution verification of autonomous agents.","additionalProperties":false,"properties":{"use_case":{"type":"string","examples":["agent-before-tool-execution","agent-before-payment"]},"action":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"amount_usd":{"type":"number"},"currency":{"type":"string"},"irreversible":{"type":"boolean"},"external_side_effect":{"type":"boolean"}}},"context":{"type":"object","additionalProperties":true,"properties":{"agent_id":{"type":"string"},"environment":{"type":"string"},"counterparty_id":{"type":"string"},"user_confirmation":{"type":"boolean"}}},"policy":{"type":"object","additionalProperties":true,"properties":{"max_risk_level":{"type":"string","enum":["low","medium","high"]},"require_trust_receipt":{"type":"boolean"},"amount_usd_limit":{"type":"number"},"blocked_action_types":{"type":"array","items":{"type":"string"}},"allowed_action_types":{"type":"array","items":{"type":"string"}},"require_human_review_above":{"type":"number","minimum":0,"maximum":1},"require_user_confirmation_for_irreversible":{"type":"boolean"}}},"domain":{"type":"string"},"mode":{"type":"string","enum":["fast_heuristic","semantic_judge"],"default":"fast_heuristic"}},"required":["use_case","action"],"example":{"use_case":"agent-before-tool-execution","action":{"type":"read_only_lookup","name":"check_order_status","description":"Read order status from an internal system","irreversible":false,"external_side_effect":false},"context":{"agent_id":"agent_demo_safe","environment":"sandbox","user_confirmation":true},"policy":{"max_risk_level":"medium","require_trust_receipt":true,"require_human_review_above":0.75}}},"VerifyRequest":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"prompt":{"type":"string"},"response":{"type":"string"},"domain":{"type":"string","default":"general"},"mode":{"type":"string","enum":["fast_heuristic","semantic_judge"],"default":"fast_heuristic"}},"required":["prompt","response"]},{"type":"object","description":"Primary autonomous_execution contract for pre-execution verification of autonomous agents.","additionalProperties":false,"properties":{"use_case":{"type":"string","examples":["agent-before-tool-execution","agent-before-payment"]},"action":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"amount_usd":{"type":"number"},"currency":{"type":"string"},"irreversible":{"type":"boolean"},"external_side_effect":{"type":"boolean"}}},"context":{"type":"object","additionalProperties":true,"properties":{"agent_id":{"type":"string"},"environment":{"type":"string"},"counterparty_id":{"type":"string"},"user_confirmation":{"type":"boolean"}}},"policy":{"type":"object","additionalProperties":true,"properties":{"max_risk_level":{"type":"string","enum":["low","medium","high"]},"require_trust_receipt":{"type":"boolean"},"amount_usd_limit":{"type":"number"},"blocked_action_types":{"type":"array","items":{"type":"string"}},"allowed_action_types":{"type":"array","items":{"type":"string"}},"require_human_review_above":{"type":"number","minimum":0,"maximum":1},"require_user_confirmation_for_irreversible":{"type":"boolean"}}},"domain":{"type":"string"},"mode":{"type":"string","enum":["fast_heuristic","semantic_judge"],"default":"fast_heuristic"}},"required":["use_case","action"],"example":{"use_case":"agent-before-tool-execution","action":{"type":"read_only_lookup","name":"check_order_status","description":"Read order status from an internal system","irreversible":false,"external_side_effect":false},"context":{"agent_id":"agent_demo_safe","environment":"sandbox","user_confirmation":true},"policy":{"max_risk_level":"medium","require_trust_receipt":true,"require_human_review_above":0.75}}}]},"VerifyBatchRequest":{"type":"object","additionalProperties":false,"properties":{"items":{"type":"array","minItems":1,"maxItems":100,"items":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"prompt":{"type":"string"},"response":{"type":"string"},"domain":{"type":"string","default":"general"},"mode":{"type":"string","enum":["fast_heuristic","semantic_judge"],"default":"fast_heuristic"}},"required":["prompt","response"]},{"type":"object","description":"Primary autonomous_execution contract for pre-execution verification of autonomous agents.","additionalProperties":false,"properties":{"use_case":{"type":"string","examples":["agent-before-tool-execution","agent-before-payment"]},"action":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"amount_usd":{"type":"number"},"currency":{"type":"string"},"irreversible":{"type":"boolean"},"external_side_effect":{"type":"boolean"}}},"context":{"type":"object","additionalProperties":true,"properties":{"agent_id":{"type":"string"},"environment":{"type":"string"},"counterparty_id":{"type":"string"},"user_confirmation":{"type":"boolean"}}},"policy":{"type":"object","additionalProperties":true,"properties":{"max_risk_level":{"type":"string","enum":["low","medium","high"]},"require_trust_receipt":{"type":"boolean"},"amount_usd_limit":{"type":"number"},"blocked_action_types":{"type":"array","items":{"type":"string"}},"allowed_action_types":{"type":"array","items":{"type":"string"}},"require_human_review_above":{"type":"number","minimum":0,"maximum":1},"require_user_confirmation_for_irreversible":{"type":"boolean"}}},"domain":{"type":"string"},"mode":{"type":"string","enum":["fast_heuristic","semantic_judge"],"default":"fast_heuristic"}},"required":["use_case","action"],"example":{"use_case":"agent-before-tool-execution","action":{"type":"read_only_lookup","name":"check_order_status","description":"Read order status from an internal system","irreversible":false,"external_side_effect":false},"context":{"agent_id":"agent_demo_safe","environment":"sandbox","user_confirmation":true},"policy":{"max_risk_level":"medium","require_trust_receipt":true,"require_human_review_above":0.75}}}]}}},"required":["items"]},"VerifyResult":{"$ref":"https://ai-risk-oracle.fly.dev/schemas/verify-result.json"},"TrustReceipt":{"$ref":"https://ai-risk-oracle.fly.dev/schemas/trust-receipt.json"},"TrustReceiptPublic":{"$ref":"https://ai-risk-oracle.fly.dev/schemas/trust-receipt-public.json"},"VerifyBatchResponse":{"type":"object","additionalProperties":false,"required":["ok","batch_size","billed","results","summary","oracle"],"properties":{"ok":{"type":"boolean","const":true},"batch_size":{"type":"integer","minimum":1},"billed":{"type":"object","additionalProperties":false,"required":["mode","cost_usdc"],"properties":{"mode":{"type":"string","enum":["account","payment_reference"]},"cost_usdc":{"type":"string"},"cost_microusdc":{"type":"integer","minimum":0},"remaining_balance_usdc":{"type":"string"},"remaining_balance_microusdc":{"type":"integer","minimum":0}}},"results":{"type":"array","items":{"$ref":"#/components/schemas/VerifyResult"}},"summary":{"type":"object","additionalProperties":false,"required":["count","avg_consistency_score","high_risk_count"],"properties":{"count":{"type":"integer","minimum":1},"avg_consistency_score":{"type":"number","minimum":0,"maximum":1},"high_risk_count":{"type":"integer","minimum":0}}},"oracle":{"type":"object","additionalProperties":false,"required":["version","signals_version","trust_signing_enabled"],"properties":{"version":{"type":"string"},"signals_version":{"type":"string"},"trust_signing_enabled":{"type":"boolean"}}}}}}},"paths":{"/":{"get":{"responses":{"200":{"description":"Human-facing landing page with integration links and discovery entry points"},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"View hosted service landing page","operationId":"getLandingPage","tags":["Discovery"],"security":[]}},"/service.json":{"get":{"responses":{"200":{"description":"Machine-readable service summary for clients that previously consumed the root JSON response"},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get legacy service summary","operationId":"getServiceSummary","tags":["Discovery"],"security":[]}},"/health":{"get":{"responses":{"200":{"description":"Liveness and runtime mode information","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["ok","service","version","payment_mode","trust_signing_enabled"],"properties":{"ok":{"type":"boolean","const":true},"service":{"type":"string"},"version":{"type":"string"},"payment_mode":{"type":"string"},"trust_signing_enabled":{"type":"boolean"}}}}}},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Check service liveness","operationId":"getHealth","tags":["Operations"],"security":[]}},"/ready":{"get":{"responses":{"200":{"description":"Readiness probe for Fly.io or other orchestrators","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["ok","ready","service","version","checks"],"properties":{"ok":{"type":"boolean","const":true},"ready":{"type":"boolean","const":true},"service":{"type":"string"},"version":{"type":"string"},"checks":{"type":"object","additionalProperties":{"type":"boolean"}}}}}}},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}},"503":{"description":"Service is alive but not production-ready","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["ok","ready","service","version","checks"],"properties":{"ok":{"type":"boolean","const":false},"ready":{"type":"boolean","const":false},"service":{"type":"string"},"version":{"type":"string"},"checks":{"type":"object","additionalProperties":{"type":"boolean"}}}}}}}},"summary":"Check production readiness","operationId":"getReady","tags":["Operations"],"security":[]}},"/.well-known/agent.json":{"get":{"responses":{"200":{"description":"A2A Agent Card for agent discovery"},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get A2A agent card","operationId":"getAgentCard","tags":["Agent Protocols"],"security":[]}},"/.well-known/ai-risk-oracle":{"get":{"responses":{"200":{"description":"Alias for the AI Risk Oracle service descriptor"},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get InterAI service descriptor alias","operationId":"getAiRiskOracleDescriptor","tags":["Discovery"],"security":[]}},"/.well-known/discovery-bundle.json":{"get":{"responses":{"200":{"description":"Single discovery bundle for agents that want service descriptor, agent card, runtime mode, schemas, and sample payloads in one fetch"},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get discovery bundle","operationId":"getDiscoveryBundle","tags":["Discovery"],"security":[]}},"/.well-known/autonomous-adoption.json":{"get":{"responses":{"200":{"description":"Machine-readable adoption guidance for agents and builders deciding when and how to use InterAI before execution"},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get autonomous adoption metadata","operationId":"getAutonomousAdoption","tags":["Discovery"],"security":[]}},"/openapi.json":{"get":{"responses":{"200":{"description":"Alias for the OpenAPI contract"},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get OpenAPI alias","operationId":"getOpenApiAlias","tags":["Discovery"],"security":[]}},"/discovery.json":{"get":{"responses":{"200":{"description":"Alias for the single-fetch discovery bundle"},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get discovery bundle alias","operationId":"getDiscoveryAlias","tags":["Discovery"],"security":[]}},"/autonomous-adoption.json":{"get":{"responses":{"200":{"description":"Alias for the autonomous adoption contract at /.well-known/autonomous-adoption.json"},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get autonomous adoption alias","operationId":"getAutonomousAdoptionAlias","tags":["Discovery"],"security":[]}},"/pricing":{"get":{"responses":{"200":{"description":"Public pricing, trial, top-up and idempotency metadata for self-serve integration"},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get public pricing metadata","operationId":"getPricing","tags":["Billing"],"security":[]}},"/robots.txt":{"get":{"responses":{"200":{"description":"Crawler policy with sitemap location","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get crawler policy","operationId":"getRobotsTxt","tags":["Discovery"],"security":[]}},"/sitemap.xml":{"get":{"responses":{"200":{"description":"XML sitemap for public discovery surfaces","content":{"application/xml":{"schema":{"type":"string"}}}},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get XML sitemap","operationId":"getSitemapXml","tags":["Discovery"],"security":[]}},"/llms.txt":{"get":{"responses":{"200":{"description":"Concise LLM-readable service summary","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get LLM discovery summary","operationId":"getLlmsTxt","tags":["Discovery"],"security":[]}},"/llms-full.txt":{"get":{"responses":{"200":{"description":"Extended LLM-readable integration context","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get extended LLM discovery context","operationId":"getLlmsFullTxt","tags":["Discovery"],"security":[]}},"/admin/stats":{"get":{"security":[{"AdminToken":[]}],"responses":{"200":{"description":"Admin operational summary with account, balance, usage, receipt, top-up, and discovery totals"},"403":{"description":"Invalid admin token"}},"summary":"Get admin operations summary","operationId":"getAdminStats","tags":["Admin"]}},"/admin/adoption/summary":{"get":{"security":[{"AdminToken":[]}],"responses":{"200":{"description":"Admin-only adoption telemetry summary for landing, discovery, pricing, onboarding, verification, receipts, x402 payment-required responses, topups, and errors"},"403":{"description":"Invalid admin token"}},"summary":"Get admin adoption telemetry summary","operationId":"getAdminAdoptionSummary","tags":["Admin"]}},"/admin/accounts":{"get":{"security":[{"AdminToken":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}}],"responses":{"200":{"description":"Admin account summaries without raw API keys"},"403":{"description":"Invalid admin token"}},"summary":"List admin account summaries","operationId":"listAdminAccounts","tags":["Admin"]}},"/admin/accounts/{accountId}/api-keys":{"get":{"security":[{"AdminToken":[]}],"parameters":[{"name":"accountId","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}}],"responses":{"200":{"description":"Admin API key metadata for an account, without raw API keys or hashes"},"403":{"description":"Invalid admin token"},"404":{"description":"Account not found"}},"summary":"List admin API key metadata","operationId":"listAdminAccountApiKeys","tags":["Admin"]}},"/mcp":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","enum":["initialize","notifications/initialized","tools/list","tools/call","resources/list","resources/read","prompts/list","prompts/get"]},"params":{"type":"object","additionalProperties":true}}}}}},"responses":{"200":{"description":"MCP JSON-RPC response supporting initialize, tools, resources, and prompts"},"202":{"description":"MCP notifications/initialized accepted without response body requirements"},"400":{"description":"Invalid JSON-RPC envelope"}},"summary":"Call experimental MCP bridge","operationId":"callMcp","tags":["Agent Protocols"],"security":[]}},"/demo":{"get":{"summary":"Safe controlled demo walkthrough","responses":{"200":{"description":"HTML demo page showing limited trial onboarding, safe read-only verify, and receipt lookup examples"},"429":{"description":"Demo page rate limited"}}}},"/onboard":{"post":{"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"account_id":{"type":"string"},"name":{"type":"string"},"api_key_name":{"type":"string"},"recommended_topup_usdc":{"type":"string"},"dev_auto_credit_usdc":{"type":"string"},"scope":{"type":"string","enum":["standard","demo_trial"],"description":"Use demo_trial for a limited, short-lived demo key."}}}}}},"responses":{"200":{"description":"Account and API key created"},"400":{"description":"Invalid onboarding request"},"404":{"description":"Onboarding disabled","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}},"429":{"description":"Trial onboarding rate limited or blocked"}},"summary":"Create a self-serve account and API key","operationId":"createOnboardingAccount","tags":["Billing"],"security":[]}},"/me":{"get":{"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Authenticated account profile and balance"},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get authenticated account profile","operationId":"getAccountProfile","tags":["Account"]}},"/ledger":{"get":{"security":[{"bearerAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Ledger entries for authenticated account"},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"List authenticated account ledger entries","operationId":"listLedgerEntries","tags":["Account"]}},"/usage":{"get":{"security":[{"bearerAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Usage events for authenticated account"},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"List authenticated account usage events","operationId":"listUsageEvents","tags":["Account"]}},"/trust/receipts":{"get":{"security":[{"bearerAuth":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200}}],"responses":{"200":{"description":"Trust receipts for authenticated account"},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"List authenticated trust receipts","operationId":"listTrustReceipts","tags":["Trust Receipts"]}},"/trust/receipts/{receiptId}":{"get":{"parameters":[{"name":"receiptId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Canonical public trust receipt representation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrustReceiptPublic"}}}},"400":{"description":"Missing receipt identifier","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}},"404":{"description":"Trust receipt not found","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get public trust receipt by ID","operationId":"getTrustReceipt","tags":["Trust Receipts"],"security":[]}},"/trust/reputation":{"get":{"security":[{"bearerAuth":[]}],"parameters":[{"name":"domains_limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Historical trust reputation summary for the authenticated account, including per-domain aggregates"},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get authenticated trust reputation","operationId":"getTrustReputation","tags":["Trust Receipts"]}},"/trust/verify-signature":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"receipt":{"type":"object"},"signature":{"type":"string"},"signature_alg":{"type":"string","enum":["hmac-sha256"]}},"required":["receipt","signature"]}}}},"responses":{"200":{"description":"Signature verification result","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["valid","signature_alg"],"properties":{"valid":{"type":"boolean"},"signature_alg":{"type":"string","enum":["hmac-sha256"]}}}}}},"400":{"description":"Malformed verification payload","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}},"503":{"description":"Receipt signing not configured on this server","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Verify a trust receipt signature","operationId":"verifyTrustReceiptSignature","tags":["Trust Receipts"],"security":[]}},"/schemas/trust-receipt.json":{"get":{"responses":{"200":{"description":"JSON Schema for canonical trust receipts"},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get canonical trust receipt schema","operationId":"getTrustReceiptSchema","tags":["Schemas"],"security":[]}},"/schemas/trust-receipt-public.json":{"get":{"responses":{"200":{"description":"JSON Schema for public trust receipt lookup responses"},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get public trust receipt lookup schema","operationId":"getPublicTrustReceiptSchema","tags":["Schemas"],"security":[]}},"/schemas/verify-result.json":{"get":{"responses":{"200":{"description":"JSON Schema for verify responses"},"400":{"description":"Invalid request or unavailable resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get verify result schema","operationId":"getVerifyResultSchema","tags":["Schemas"],"security":[]}},"/topup/create":{"post":{"security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"account_id":{"type":"string"},"amount_usdc":{"type":"string"}}}}}},"responses":{"200":{"description":"Top-up intent created"},"400":{"description":"Missing account context","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Create an onchain top-up intent","operationId":"createTopup","tags":["Billing"]}},"/topup/confirm":{"post":{"parameters":[{"name":"X-Topup-Id","in":"header","required":true,"schema":{"type":"string"}},{"name":"X-Tx-Hash","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Top-up confirmed and credited"},"400":{"description":"Invalid or expired top-up","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}},"402":{"description":"Transaction verification failed","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Confirm an onchain top-up transaction","operationId":"confirmTopup","tags":["Billing"],"security":[]}},"/topup/{topupId}":{"get":{"parameters":[{"name":"topupId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Top-up status"},"404":{"description":"Top-up not found","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Get top-up status","operationId":"getTopup","tags":["Billing"],"security":[]}},"/verify":{"post":{"security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"x402 v2 payment payload. Use either PAYMENT-SIGNATURE or bearer auth, not both."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"prompt":{"type":"string"},"response":{"type":"string"},"domain":{"type":"string","default":"general"},"mode":{"type":"string","enum":["fast_heuristic","semantic_judge"],"default":"fast_heuristic"}},"required":["prompt","response"]},{"type":"object","description":"Primary autonomous_execution contract for pre-execution verification of autonomous agents.","additionalProperties":false,"properties":{"use_case":{"type":"string","examples":["agent-before-tool-execution","agent-before-payment"]},"action":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"amount_usd":{"type":"number"},"currency":{"type":"string"},"irreversible":{"type":"boolean"},"external_side_effect":{"type":"boolean"}}},"context":{"type":"object","additionalProperties":true,"properties":{"agent_id":{"type":"string"},"environment":{"type":"string"},"counterparty_id":{"type":"string"},"user_confirmation":{"type":"boolean"}}},"policy":{"type":"object","additionalProperties":true,"properties":{"max_risk_level":{"type":"string","enum":["low","medium","high"]},"require_trust_receipt":{"type":"boolean"},"amount_usd_limit":{"type":"number"},"blocked_action_types":{"type":"array","items":{"type":"string"}},"allowed_action_types":{"type":"array","items":{"type":"string"}},"require_human_review_above":{"type":"number","minimum":0,"maximum":1},"require_user_confirmation_for_irreversible":{"type":"boolean"}}},"domain":{"type":"string"},"mode":{"type":"string","enum":["fast_heuristic","semantic_judge"],"default":"fast_heuristic"}},"required":["use_case","action"],"example":{"use_case":"agent-before-tool-execution","action":{"type":"read_only_lookup","name":"check_order_status","description":"Read order status from an internal system","irreversible":false,"external_side_effect":false},"context":{"agent_id":"agent_demo_safe","environment":"sandbox","user_confirmation":true},"policy":{"max_risk_level":"medium","require_trust_receipt":true,"require_human_review_above":0.75}}}]}}}},"responses":{"200":{"description":"Autonomous execution decision. score is a risk score from 0 to 1; higher means higher execution risk. signals is an object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyResult"},"example":{"decision_id":"tr_example","request_contract":"autonomous_execution","score":0.34,"risk_level":"low","signals":{"semantic_relevance":0.9,"contradiction_risk":0.05,"unsupported_specificity":0.08,"numeric_consistency":1,"overconfidence":0.1,"has_external_side_effect":false,"is_irreversible":false,"involves_money":false,"amount_usd":null,"requires_user_confirmation":true,"has_counterparty":false,"environment":"sandbox","action_type":"read_only_lookup","autonomous_execution_detected":true},"recommended_action":"allow","policy_result":"allow","policy_violations":[],"trust_receipt_id":"tr_example","consistency_score":0.86,"hallucination_risk":0.14,"analysis":{"prompt_response_alignment":0.86,"prompt_response_alignment_adjusted":0.86,"contradictions_detected":false,"numerical_conflicts":false,"absolute_claims":0,"latency_ms":12,"engine_latency_ms":12,"total_latency_ms":12,"engine_version":"0.0.1"},"verdict":"accept","trust_score":0.82,"trust_recommended_action":"accept","confidence_band":"high","risk_factors":[],"claims_checked":1,"claims_supported":1,"claims_uncertain":0,"historical_context":{"available":false,"scope":"none","domain":"autonomous_execution","sample_size":0,"average_trust_score":null,"min_trust_score":null,"max_trust_score":null,"high_risk_count":0,"medium_risk_count":0,"low_risk_count":0,"high_risk_rate":null,"latest_receipt_at":null,"prior_to_current":true,"reason":"account_history_unavailable"},"trust_receipt":{"receipt_id":"tr_example","issued_at":"2026-06-15T00:00:00.000Z","oracle_version":"0.0.1","signals_version":"signals-v1","request_hash":"sha256:example","verdict":"accept","confidence":0.82,"risk_level":"low","confidence_band":"high","risk_factors":[],"claims_checked":1,"claims_supported":1,"claims_uncertain":0,"decision_basis":{"dominant_negatives":[],"dominant_positives":["read-only action","sandbox environment"]},"signature":"hmac-sha256:redacted-example","signature_alg":"hmac-sha256","signed":true},"verification_mode":"fast_heuristic","semantic_judge":null,"oracle":{"version":"0.0.1","signals_version":"signals-v1","verification_mode":"fast_heuristic","trust_signing_enabled":true}}}}},"400":{"description":"Ambiguous payment mode or malformed request","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}},"402":{"description":"Insufficient prepaid balance, x402 payment required, or x402 settlement failure","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"500":{"description":"Onchain verification backend failure","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Verify an autonomous action before execution","operationId":"verifyAction","tags":["Verification"]}},"/verify/batch":{"post":{"security":[{"bearerAuth":[]}],"parameters":[{"name":"X-Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"x402 v2 payment payload. Use either PAYMENT-SIGNATURE or bearer auth, not both."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"items":{"type":"array","minItems":1,"maxItems":100,"items":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"prompt":{"type":"string"},"response":{"type":"string"},"domain":{"type":"string","default":"general"},"mode":{"type":"string","enum":["fast_heuristic","semantic_judge"],"default":"fast_heuristic"}},"required":["prompt","response"]},{"type":"object","description":"Primary autonomous_execution contract for pre-execution verification of autonomous agents.","additionalProperties":false,"properties":{"use_case":{"type":"string","examples":["agent-before-tool-execution","agent-before-payment"]},"action":{"type":"object","additionalProperties":true,"properties":{"type":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"amount_usd":{"type":"number"},"currency":{"type":"string"},"irreversible":{"type":"boolean"},"external_side_effect":{"type":"boolean"}}},"context":{"type":"object","additionalProperties":true,"properties":{"agent_id":{"type":"string"},"environment":{"type":"string"},"counterparty_id":{"type":"string"},"user_confirmation":{"type":"boolean"}}},"policy":{"type":"object","additionalProperties":true,"properties":{"max_risk_level":{"type":"string","enum":["low","medium","high"]},"require_trust_receipt":{"type":"boolean"},"amount_usd_limit":{"type":"number"},"blocked_action_types":{"type":"array","items":{"type":"string"}},"allowed_action_types":{"type":"array","items":{"type":"string"}},"require_human_review_above":{"type":"number","minimum":0,"maximum":1},"require_user_confirmation_for_irreversible":{"type":"boolean"}}},"domain":{"type":"string"},"mode":{"type":"string","enum":["fast_heuristic","semantic_judge"],"default":"fast_heuristic"}},"required":["use_case","action"],"example":{"use_case":"agent-before-tool-execution","action":{"type":"read_only_lookup","name":"check_order_status","description":"Read order status from an internal system","irreversible":false,"external_side_effect":false},"context":{"agent_id":"agent_demo_safe","environment":"sandbox","user_confirmation":true},"policy":{"max_risk_level":"medium","require_trust_receipt":true,"require_human_review_above":0.75}}}]}}},"required":["items"]}}}},"responses":{"200":{"description":"Batch verification result","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["ok","batch_size","billed","results","summary","oracle"],"properties":{"ok":{"type":"boolean","const":true},"batch_size":{"type":"integer","minimum":1},"billed":{"type":"object","additionalProperties":false,"required":["mode","cost_usdc"],"properties":{"mode":{"type":"string","enum":["account","payment_reference"]},"cost_usdc":{"type":"string"},"cost_microusdc":{"type":"integer","minimum":0},"remaining_balance_usdc":{"type":"string"},"remaining_balance_microusdc":{"type":"integer","minimum":0}}},"results":{"type":"array","items":{"$ref":"#/components/schemas/VerifyResult"}},"summary":{"type":"object","additionalProperties":false,"required":["count","avg_consistency_score","high_risk_count"],"properties":{"count":{"type":"integer","minimum":1},"avg_consistency_score":{"type":"number","minimum":0,"maximum":1},"high_risk_count":{"type":"integer","minimum":0}}},"oracle":{"type":"object","additionalProperties":false,"required":["version","signals_version","trust_signing_enabled"],"properties":{"version":{"type":"string"},"signals_version":{"type":"string"},"trust_signing_enabled":{"type":"boolean"}}}}}}}},"400":{"description":"Malformed batch payload or batch size out of range","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}},"401":{"description":"Invalid API key","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}},"402":{"description":"Insufficient balance or payment required","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}},"500":{"description":"Onchain verification backend failure","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"type":"string"}}}}}}},"summary":"Verify a batch of actions or legacy prompt responses","operationId":"verifyBatch","tags":["Verification"]}},"/a2a":{"post":{"security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["jsonrpc","id","method","params"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string","enum":["message/send"]},"params":{"type":"object","additionalProperties":true,"properties":{"message":{"type":"object","additionalProperties":true,"required":["role","parts","messageId"],"properties":{"role":{"type":"string","enum":["user"]},"messageId":{"type":"string"},"contextId":{"type":"string"},"parts":{"type":"array","minItems":1,"items":{"oneOf":[{"type":"object","additionalProperties":true,"required":["kind","text"],"properties":{"kind":{"type":"string","enum":["text"]},"text":{"type":"string"}}},{"type":"object","additionalProperties":true,"required":["kind","data"],"properties":{"kind":{"type":"string","enum":["data"]},"data":{"type":"object","additionalProperties":true,"description":"Either { prompt, response, domain? } or { items: [...] }"}}}]}}}},"metadata":{"type":"object","additionalProperties":true,"properties":{"idempotency_key":{"type":"string"}}}}}}}}}},"responses":{"200":{"description":"JSON-RPC success or error response for A2A synchronous verification"},"400":{"description":"Invalid JSON-RPC envelope"}},"summary":"Call experimental A2A verification endpoint","operationId":"callA2A","tags":["Agent Protocols"]}}},"tags":[{"name":"Discovery","description":"Public metadata and discovery endpoints."},{"name":"Verification","description":"Pre-execution verification for autonomous agents."},{"name":"Billing","description":"Pricing, onboarding, x402, and top-up metadata."},{"name":"Trust Receipts","description":"Trust receipt lookup, listing, reputation, and signature checks."},{"name":"Account","description":"Authenticated account state and usage."},{"name":"Agent Protocols","description":"Experimental MCP and A2A integration surfaces."},{"name":"Schemas","description":"Public JSON Schemas for client validation."},{"name":"Admin","description":"Admin-only operational metadata."},{"name":"Operations","description":"Health and readiness checks."}]}