{ "openapi": "3.1.0", "info": { "title": "AgentProof — Autonomous Transaction Trust Infrastructure", "version": "5.0.0", "description": "AgentProof is the independent transaction-assurance checkpoint between autonomous intent and irreversible action, with recursive authority resolution, live revocation, consequence-bounded execution, authenticated decision proofs, replay-resistant one-time execution permits, before/after Continuity Capsule™ lineage, and permanent post-transaction proof.", "x-guidance": "For enterprise autonomous actions, provide consequence_boundary to bound maximum permitted blast radius and continuity.pre_state_sha256 / continuity.expected_effects to create a before/after lineage. AgentProof denies a boundary violation even when inherited authority is otherwise valid. Every enterprise resolution creates a Continuity Capsule™ with SHA-256 + SHA-512 digests. Close it after execution with observed outcome and post-state, and re-attest it later without rewriting history." }, "servers": [ { "url": "https://agentproof.hatchable.site" } ], "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "description": "AgentProof enterprise API key. Each key is bound to one organization and one environment." } } }, "paths": { "/api/agent-contact": { "post": { "operationId": "contact_agentproof_as_agent", "summary": "Open a structured machine-to-machine inquiry with AgentProof", "description": "Public agent-native contact surface for integration, interoperability, partnership, or trust inquiries. No human sales form is required.", "requestBody": {"required":true,"content":{"application/json":{"schema":{"type":"object","required":["use_case"],"properties":{"agent_url":{"type":"string","format":"uri"},"agent_card_url":{"type":"string","format":"uri"},"network":{"type":"string"},"use_case":{"type":"string"},"callback_url":{"type":"string","format":"uri"},"capabilities":{"type":"array","items":{"type":"string"}},"requested_action":{"type":"string"}}}}}}, "responses": {"202":{"description":"Inquiry accepted with AgentProof discovery and buy-now endpoints"},"200":{"description":"Duplicate inquiry already received"},"400":{"description":"Missing use case or machine identity/callback"}} } }, "/api/a2a": { "post": { "operationId": "agentproof_a2a_send_message", "summary": "AgentProof A2A v1.0 JSON-RPC front door", "description": "Supports SendMessage discovery queries for AgentProof pricing, trust, integration, commerce, and long-horizon continuity.", "responses": {"200":{"description":"A2A task response"},"400":{"description":"Invalid JSON-RPC or A2A request"}} } }, "/api/pilot/provision": { "post": { "operationId": "provision_self_service_pilot", "summary": "Provision a 24-hour AgentProof enterprise test tenant", "description": "Creates an isolated test-only organization, environment, versioned default policy and scoped expiring API key. Test tenants cannot mint execution permits or authorize production commits.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "email", "company" ], "properties": { "name": { "type": "string" }, "email": { "type": "string", "format": "email" }, "company": { "type": "string" }, "role": { "type": "string" }, "use_case": { "type": "string" } } } } } }, "responses": { "201": { "description": "Test tenant and one-time API key" }, "429": { "description": "Pilot rate limit reached" } } } }, "/api/pilot/demo": { "post": { "operationId": "run_enterprise_pilot_demo", "summary": "Simulate an AgentProof enterprise policy decision with no production effect", "description": "Public demo only. Never creates a production resolution, payment, execution permit, or durable authority record.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "policy_max": { "type": "number" }, "amount": { "type": "number" }, "allowed_counterparty": { "type": "string" }, "counterparty": { "type": "string" }, "human_above": { "type": [ "number", "null" ] } } } } } }, "responses": { "200": { "description": "Simulated policy decision" } } } }, "/api/v1": { "get": { "operationId": "get_enterprise_control_plane", "summary": "Discover the AgentProof Enterprise Control Plane", "responses": { "200": { "description": "Enterprise tenancy, authentication, policy and endpoint discovery" } } } }, "/api/v1/resolve": { "post": { "operationId": "enterprise_resolve_transaction", "summary": "Resolve an autonomous transaction under a tenant-scoped enterprise policy", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "Authenticated resolution, Consequence Boundary™, Continuity Capsule™, policy provenance and optional one-time execution permit" }, "401": { "description": "Missing or invalid enterprise API key" }, "403": { "description": "Key lacks resolve scope" } }, "description": "Resolve inherited authority and enterprise policy, enforce the optional Consequence Boundary™, authenticate the decision, issue a live one-time execution permit only when eligible, and create a Continuity Capsule™ for before/after proof." } }, "/api/v1/whoami": { "get": { "operationId": "enterprise_whoami", "summary": "Inspect the organization, environment and scopes bound to the current API key", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Tenant and API-key identity" } } } }, "/api/v1/usage": { "get": { "operationId": "enterprise_usage", "summary": "Read tenant-scoped metered usage", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Usage summary and recent events" } } } }, "/api/v1/audit": { "get": { "operationId": "enterprise_audit", "summary": "Read the tenant/environment audit stream", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Recent immutable audit events" } } } }, "/api/signing-provider": { "get": { "operationId": "get_signing_provider", "summary": "Inspect the active proof-signing provider profile", "responses": { "200": { "description": "Current signer mode, algorithm, key reference and asymmetric migration readiness" } } } }, "/api/keys": { "get": { "operationId": "get_signing_keys", "summary": "Get AgentProof resolution-proof key metadata", "responses": { "200": { "description": "Active/retired proof-authentication key metadata; symmetric HS256 secret material is never exposed" } } } }, "/api/resolutions/verify": { "post": { "operationId": "verify_resolution_proof", "summary": "Verify an AgentProof authenticated resolution proof", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" } } } }, "responses": { "200": { "description": "Signature verified" }, "400": { "description": "Proof invalid" } } } }, "/api/resolutions/{id}": { "get": { "operationId": "get_resolution_proof", "summary": "Look up a registered resolution and its signed proof", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Resolution metadata and proof" }, "404": { "description": "Resolution not found" } } } }, "/api/permits/consume": { "post": { "operationId": "consume_execution_permit", "summary": "Consume a short-lived single-use execution permit", "description": "Consumes the permit atomically and rechecks registry-backed delegated authority for revocation before commit.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "permit_id", "token" ], "properties": { "permit_id": { "type": "string", "format": "uuid" }, "token": { "type": "string" } } } } } }, "responses": { "200": { "description": "Commit authorized and permit consumed" }, "409": { "description": "Permit replayed or authority changed/revoked" }, "410": { "description": "Permit expired" } } } }, "/api/permits/{id}": { "get": { "operationId": "get_execution_permit_status", "summary": "Get execution permit status", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Permit ready, consumed or expired" } } } }, "/api/conformance/resolution": { "get": { "operationId": "run_resolution_conformance", "summary": "Run the public Autonomous Trust Resolution conformance suite", "responses": { "200": { "description": "All core invariant fixtures passed" }, "500": { "description": "One or more conformance fixtures failed" } } } }, "/api/readiness": { "get": { "operationId": "get_agentproof_readiness", "summary": "Get public AgentProof service readiness", "responses": { "200": { "description": "Signing, protocols, conformance links and durable-object counts" } } } }, "/api/positioning": { "get": { "operationId": "get_agentproof_positioning", "summary": "Discover where AgentProof fits in the agent-commerce stack", "description": "Machine-readable product placement across tool access, agent coordination, payment authorization, value transfer and permanent transaction proof.", "responses": { "200": { "description": "Stack map, control loop, placement points, moat and non-claims" } } } }, "/api/paid/check_url_alive": { "post": { "operationId": "check_url_alive", "summary": "Reachability + title", "description": "x402 payment required; price $0.01 USDC on Base.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri" } } } } } }, "responses": { "200": { "description": "Successful paid AgentProof result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "service": { "type": "string" }, "version": { "type": "string" }, "tool": { "type": "string" }, "price_usd": { "type": "number" }, "result": { "type": "object", "additionalProperties": true }, "receipt": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "integrity_sha256": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "created_at": { "type": "string", "format": "date-time" } }, "additionalProperties": true }, "payment": { "type": "object", "additionalProperties": true } }, "required": [ "ok", "service", "tool", "price_usd", "result" ] } } } }, "402": { "description": "Payment Required" } }, "tags": [ "Verification" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": {} } ] } } }, "/api/paid/detect_page_change": { "post": { "operationId": "detect_page_change", "summary": "Compare current SHA-256 to a prior fingerprint", "description": "x402 payment required; price $0.03 USDC on Base.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri" } } } } } }, "responses": { "200": { "description": "Successful paid AgentProof result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "service": { "type": "string" }, "version": { "type": "string" }, "tool": { "type": "string" }, "price_usd": { "type": "number" }, "result": { "type": "object", "additionalProperties": true }, "receipt": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "integrity_sha256": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "created_at": { "type": "string", "format": "date-time" } }, "additionalProperties": true }, "payment": { "type": "object", "additionalProperties": true } }, "required": [ "ok", "service", "tool", "price_usd", "result" ] } } } }, "402": { "description": "Payment Required" } }, "tags": [ "Verification" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.030000" }, "protocols": [ { "x402": {} } ] } } }, "/api/paid/extract_page_facts": { "post": { "operationId": "extract_page_facts", "summary": "Concise facts from page text", "description": "x402 payment required; price $0.05 USDC on Base.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri" } } } } } }, "responses": { "200": { "description": "Successful paid AgentProof result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "service": { "type": "string" }, "version": { "type": "string" }, "tool": { "type": "string" }, "price_usd": { "type": "number" }, "result": { "type": "object", "additionalProperties": true }, "receipt": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "integrity_sha256": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "created_at": { "type": "string", "format": "date-time" } }, "additionalProperties": true }, "payment": { "type": "object", "additionalProperties": true } }, "required": [ "ok", "service", "tool", "price_usd", "result" ] } } } }, "402": { "description": "Payment Required" } }, "tags": [ "Verification" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] } } }, "/api/paid/timestamp_evidence": { "post": { "operationId": "timestamp_evidence", "summary": "Timestamp + SHA-256", "description": "x402 payment required; price $0.05 USDC on Base.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri" } } } } } }, "responses": { "200": { "description": "Successful paid AgentProof result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "service": { "type": "string" }, "version": { "type": "string" }, "tool": { "type": "string" }, "price_usd": { "type": "number" }, "result": { "type": "object", "additionalProperties": true }, "receipt": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "integrity_sha256": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "created_at": { "type": "string", "format": "date-time" } }, "additionalProperties": true }, "payment": { "type": "object", "additionalProperties": true } }, "required": [ "ok", "service", "tool", "price_usd", "result" ] } } } }, "402": { "description": "Payment Required" } }, "tags": [ "Verification" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] } } }, "/api/paid/verify_url": { "post": { "operationId": "verify_url", "summary": "Independent URL evidence receipt", "description": "x402 payment required; price $0.10 USDC on Base.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri" } } } } } }, "responses": { "200": { "description": "Successful paid AgentProof result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "service": { "type": "string" }, "version": { "type": "string" }, "tool": { "type": "string" }, "price_usd": { "type": "number" }, "result": { "type": "object", "additionalProperties": true }, "receipt": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "integrity_sha256": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "created_at": { "type": "string", "format": "date-time" } }, "additionalProperties": true }, "payment": { "type": "object", "additionalProperties": true } }, "required": [ "ok", "service", "tool", "price_usd", "result" ] } } } }, "402": { "description": "Payment Required" } }, "tags": [ "Verification" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/paid/compare_two_sources": { "post": { "operationId": "compare_two_sources", "summary": "Compare two source fingerprints", "description": "x402 payment required; price $0.10 USDC on Base.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "urlA", "urlB" ], "properties": { "urlA": { "type": "string", "format": "uri" }, "urlB": { "type": "string", "format": "uri" } } } } } }, "responses": { "200": { "description": "Successful paid AgentProof result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "service": { "type": "string" }, "version": { "type": "string" }, "tool": { "type": "string" }, "price_usd": { "type": "number" }, "result": { "type": "object", "additionalProperties": true }, "receipt": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "integrity_sha256": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "created_at": { "type": "string", "format": "date-time" } }, "additionalProperties": true }, "payment": { "type": "object", "additionalProperties": true } }, "required": [ "ok", "service", "tool", "price_usd", "result" ] } } } }, "402": { "description": "Payment Required" } }, "tags": [ "Verification" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/paid/create_evidence_receipt": { "post": { "operationId": "create_evidence_receipt", "summary": "Citation-ready durable evidence", "description": "x402 payment required; price $0.10 USDC on Base.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri" } } } } } }, "responses": { "200": { "description": "Successful paid AgentProof result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "service": { "type": "string" }, "version": { "type": "string" }, "tool": { "type": "string" }, "price_usd": { "type": "number" }, "result": { "type": "object", "additionalProperties": true }, "receipt": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "integrity_sha256": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "created_at": { "type": "string", "format": "date-time" } }, "additionalProperties": true }, "payment": { "type": "object", "additionalProperties": true } }, "required": [ "ok", "service", "tool", "price_usd", "result" ] } } } }, "402": { "description": "Payment Required" } }, "tags": [ "Verification" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/paid/verify_business_contact": { "post": { "operationId": "verify_business_contact", "summary": "Public-site contact evidence", "description": "x402 payment required; price $0.10 USDC on Base.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri" } } } } } }, "responses": { "200": { "description": "Successful paid AgentProof result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "service": { "type": "string" }, "version": { "type": "string" }, "tool": { "type": "string" }, "price_usd": { "type": "number" }, "result": { "type": "object", "additionalProperties": true }, "receipt": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "integrity_sha256": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "created_at": { "type": "string", "format": "date-time" } }, "additionalProperties": true }, "payment": { "type": "object", "additionalProperties": true } }, "required": [ "ok", "service", "tool", "price_usd", "result" ] } } } }, "402": { "description": "Payment Required" } }, "tags": [ "Verification" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.100000" }, "protocols": [ { "x402": {} } ] } } }, "/api/paid/verify_claim_sources": { "post": { "operationId": "verify_claim_sources", "summary": "Up to five-source provenance bundle", "description": "x402 payment required; price $0.20 USDC on Base.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "claim", "urls" ], "properties": { "claim": { "type": "string" }, "urls": { "type": "array", "minItems": 1, "maxItems": 5, "items": { "type": "string", "format": "uri" } } } } } } }, "responses": { "200": { "description": "Successful paid AgentProof result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "service": { "type": "string" }, "version": { "type": "string" }, "tool": { "type": "string" }, "price_usd": { "type": "number" }, "result": { "type": "object", "additionalProperties": true }, "receipt": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "integrity_sha256": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "created_at": { "type": "string", "format": "date-time" } }, "additionalProperties": true }, "payment": { "type": "object", "additionalProperties": true } }, "required": [ "ok", "service", "tool", "price_usd", "result" ] } } } }, "402": { "description": "Payment Required" } }, "tags": [ "Verification" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.200000" }, "protocols": [ { "x402": {} } ] } } }, "/api/paid/batch_check_urls": { "post": { "operationId": "batch_check_urls", "summary": "Up to 25 URLs in one call", "description": "x402 payment required; price $0.25 USDC on Base.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "urls" ], "properties": { "urls": { "type": "array", "minItems": 1, "maxItems": 25, "items": { "type": "string", "format": "uri" } } } } } } }, "responses": { "200": { "description": "Successful paid AgentProof result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "service": { "type": "string" }, "version": { "type": "string" }, "tool": { "type": "string" }, "price_usd": { "type": "number" }, "result": { "type": "object", "additionalProperties": true }, "receipt": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "integrity_sha256": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "created_at": { "type": "string", "format": "date-time" } }, "additionalProperties": true }, "payment": { "type": "object", "additionalProperties": true } }, "required": [ "ok", "service", "tool", "price_usd", "result" ] } } } }, "402": { "description": "Payment Required" } }, "tags": [ "Verification" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.250000" }, "protocols": [ { "x402": {} } ] } } }, "/api/paid/watch_url": { "post": { "operationId": "watch_url", "summary": "24-hour hourly watch + signed webhook", "description": "x402 payment required; price $0.25 USDC on Base.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri" }, "webhook_url": { "type": "string", "format": "uri" } } } } } }, "responses": { "200": { "description": "Successful paid AgentProof result", "content": { "application/json": { "schema": { "type": "object", "properties": { "ok": { "type": "boolean" }, "service": { "type": "string" }, "version": { "type": "string" }, "tool": { "type": "string" }, "price_usd": { "type": "number" }, "result": { "type": "object", "additionalProperties": true }, "receipt": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "format": "uuid" }, "integrity_sha256": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "created_at": { "type": "string", "format": "date-time" } }, "additionalProperties": true }, "payment": { "type": "object", "additionalProperties": true } }, "required": [ "ok", "service", "tool", "price_usd", "result" ] } } } }, "402": { "description": "Payment Required" } }, "tags": [ "Verification" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.250000" }, "protocols": [ { "x402": {} } ] } } }, "/api/pricing": { "get": { "operationId": "get_pricing", "responses": { "200": { "description": "Machine-readable prices, access models, composed bundles, live limits and organization capacity profiles" } } } }, "/api/catalog": { "get": { "operationId": "get_catalog", "responses": { "200": { "description": "Universal AgentProof product catalog with all live paid tools, exact-price compositions and buying paths" } } } }, "/api/recommend": { "post": { "operationId": "recommend_agentproof_setup", "summary": "Recommend the smallest correct AgentProof setup", "description": "Free planning endpoint. Uses production status, monthly consequential-action volume, delegated authority, evidence, permanent-record, monitoring and organization-control needs to recommend an access model, capacity profile and exact live-tool composition without purchasing anything.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "production": {"type": "boolean"}, "monthly_actions": {"type": "integer", "minimum": 0}, "delegated_authority": {"type": "boolean"}, "durable_evidence": {"type": "boolean"}, "permanent_record": {"type": "boolean"}, "monitor_after": {"type": "boolean"}, "organization_controls": {"type": "boolean"} } } } } }, "responses": { "200": {"description": "Minimal recommended access model, capacity profile, live-tool composition, exact per-composition price and rationale"} } } }, "/api/capabilities": { "get": { "operationId": "get_capabilities", "responses": { "200": { "description": "Service capabilities and limits" } } } }, "/api/stats": { "get": { "operationId": "get_stats", "responses": { "200": { "description": "Aggregate receipt and watch counts" } } } }, "/api/receipts/{id}": { "get": { "operationId": "get_receipt", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Durable evidence receipt" }, "404": { "description": "Receipt not found" } } } }, "/api/watch/{id}": { "get": { "operationId": "get_watch_status", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "token", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Watch state and recent change events" } } } }, "/api/standards": { "get": { "operationId": "get_standards", "summary": "Discover AgentProof public standards", "responses": { "200": { "description": "Published standards and machine-readable links" } } } }, "/api/passports/example": { "get": { "operationId": "get_atp_example", "summary": "Get an illustrative Agent Transaction Passport™ v0.1 object", "responses": { "200": { "description": "Illustrative ATP object" } } } }, "/api/passports/validate": { "post": { "operationId": "validate_atp", "summary": "Validate Agent Transaction Passport™ v0.1 structure and integrity digest", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://agentproof.hatchable.site/standards/agent-transaction-passport-v0.1.schema.json" } } } }, "responses": { "200": { "description": "ATP conformance and digest validation result" } } } }, "/api/paid/create_authority_envelope": { "post": { "operationId": "create_authority_envelope", "summary": "Issue an Authority Envelope™ delegation record", "description": "x402 payment required; price $0.05 USDC on Base. Registers exact delegation bytes with live active/revoked state and returns a private revoke token.", "tags": [ "Transaction Trust", "Authority" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.050000" }, "protocols": [ { "x402": {} } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "delegator", "delegatee", "scope" ], "properties": { "delegator": { "type": "object", "required": [ "id" ], "additionalProperties": true }, "delegatee": { "type": "object", "required": [ "id" ], "additionalProperties": true }, "scope": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "limits": { "type": "object", "additionalProperties": true }, "valid_from": { "type": "string", "format": "date-time" }, "valid_until": { "type": "string", "format": "date-time" }, "credential_refs": { "type": "array", "items": { "type": "string" } }, "attestations": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "visibility": { "type": "string", "enum": [ "private", "unlisted", "public" ] } } } } } }, "responses": { "200": { "description": "Issued Authority Envelope™ with authority_ref, resolver-ready chain_link, status URL, and private revocation capability" }, "402": { "description": "Payment Required" } } } }, "/api/authority/{id}": { "get": { "operationId": "get_authority_status", "summary": "Get Authority Envelope™ status", "tags": [ "Transaction Trust", "Authority" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "token", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Authority status and, when permitted, delegation payload" }, "404": { "description": "Authority record not found" } } } }, "/api/authority/revoke": { "post": { "operationId": "revoke_authority", "summary": "Revoke an Authority Envelope™", "tags": [ "Transaction Trust", "Authority" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "authority_id", "revoke_token" ], "properties": { "authority_id": { "type": "string", "format": "uuid" }, "revoke_token": { "type": "string" }, "reason": { "type": "string", "maxLength": 500 } } } } } }, "responses": { "200": { "description": "Authority is revoked; future registry-aware resolutions deny use of the delegation" }, "403": { "description": "Invalid revoke token" } } } }, "/api/paid/create_transaction_passport": { "post": { "operationId": "create_transaction_passport", "summary": "Issue an Agent Transaction Passport™ v0.1", "description": "x402 payment required; price $0.25 USDC on Base. Produces a portable integrity-hashed transaction record.", "tags": [ "Verification", "Transaction Trust" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.250000" }, "protocols": [ { "x402": {} } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "principal", "agent", "mandate", "counterparty", "agreement", "fulfillment", "settlement" ], "properties": { "principal": { "type": "object", "additionalProperties": true }, "agent": { "type": "object", "additionalProperties": true }, "mandate": { "type": "object", "additionalProperties": true }, "counterparty": { "type": "object", "additionalProperties": true }, "agreement": { "type": "object", "additionalProperties": true }, "evidence": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "fulfillment": { "type": "object", "additionalProperties": true }, "settlement": { "type": "object", "additionalProperties": true }, "attestations": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "jurisdiction": { "type": "object", "additionalProperties": true }, "privacy": { "type": "object", "additionalProperties": true }, "previous_passport_hash": { "type": "string" }, "authorization_resolution_id": { "type": "string", "format": "uuid", "description": "Optional registered AgentProof resolution to bind into the ATP. The stored decision must be ALLOW or ALLOW_WITH_LIMITS and principal, agent, and counterparty fingerprints must match." } } } } } }, "responses": { "200": { "description": "Issued Agent Transaction Passport™ plus AgentProof durable payment receipt" }, "402": { "description": "Payment Required" } } } }, "/api/resolution/policy": { "get": { "operationId": "get_resolution_policy", "summary": "Discover the Autonomous Trust Resolution protocol and reference policy", "responses": { "200": { "description": "Resolution protocol, decisions, specification, schema and paid endpoint" } }, "description": "Returns v0.1 and v0.2 protocol discovery, including recursive authority-chain rules." } }, "/api/paid/resolve_transaction": { "post": { "operationId": "resolve_transaction", "summary": "Resolve a direct or recursively delegated autonomous transaction", "description": "x402 payment required; price $0.01 USDC on Base. Supports direct mandate resolution v0.1 and recursive authority-chain resolution v0.2.", "tags": [ "Transaction Trust", "Admission Control" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.010000" }, "protocols": [ { "x402": {} } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://agentproof.hatchable.site/standards/autonomous-trust-resolution-v0.2.schema.json" } } } }, "responses": { "200": { "description": "Paid resolution decision and durable AgentProof receipt" }, "402": { "description": "Payment Required" } } } }, "/api/growth/kit": { "get": { "operationId": "get_integration_kit", "summary": "Discover AgentProof integration and commercial evaluation paths", "responses": { "200": { "description": "Integration kit and best-fit customer paths" } } } }, "/api/growth/sandbox": { "post": { "operationId": "sandbox_resolve_transaction", "summary": "Run a free non-production recursive trust-resolution demo", "description": "Demo identifiers must begin with demo:. Results are non-authoritative, non-persistent and non-billable.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "https://agentproof.hatchable.site/standards/autonomous-trust-resolution-v0.2.schema.json" } } } }, "responses": { "200": { "description": "Non-production sandbox resolution" }, "400": { "description": "Sandbox validation error" } } } }, "/api/growth/lead": { "post": { "operationId": "request_agentproof_integration", "summary": "Request AgentProof integration help", "description": "Capture a developer, enterprise or platform-partner inquiry with acquisition attribution.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "email" ], "properties": { "email": { "type": "string", "format": "email" }, "name": { "type": "string" }, "company": { "type": "string" }, "role": { "type": "string" }, "segment": { "enum": [ "developer", "enterprise", "partner", "investor", "standards", "other" ] }, "use_case": { "type": "string" }, "source": { "type": "string" }, "medium": { "type": "string" }, "campaign": { "type": "string" }, "referral_code": { "type": "string" } } } } } }, "responses": { "200": { "description": "Lead captured" }, "400": { "description": "Valid email required" } } } }, "/api/v1/continuity/close": { "post": { "operationId": "close_continuity_capsule", "summary": "Close a Continuity Capsule™ after execution", "description": "Bind observed outcome, optional post-state digest, observed effects, settlement and evidence to the pre-action capsule; returns expected-vs-observed divergence and a new dual-digest closure commitment.", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "capsule_id", "outcome" ], "properties": { "capsule_id": { "type": "string", "format": "uuid" }, "outcome": { "type": "string", "enum": [ "success", "partial", "failed", "disputed", "reversed", "unknown" ] }, "post_state_sha256": { "type": "string" }, "observed_effects": { "type": "array", "items": {} }, "settlement": { "type": "object" }, "evidence": { "type": "array", "items": {} } } } } } }, "responses": { "200": { "description": "Capsule closed with divergence and digest suite" }, "409": { "description": "Capsule cannot be closed" } } } }, "/api/v1/continuity/reattest": { "post": { "operationId": "reattest_continuity_capsule", "summary": "Append a cryptographic succession attestation", "description": "Re-attest a Continuity Capsule™ without rewriting its historical bytes. Each attestation points to its predecessor.", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "capsule_id" ], "properties": { "capsule_id": { "type": "string", "format": "uuid" }, "reason": { "type": "string" } } } } } }, "responses": { "200": { "description": "Append-only continuity attestation" } } } }, "/api/continuity/{id}": { "get": { "operationId": "get_public_continuity_capsule", "summary": "Get the public hash-only status of a Continuity Capsule™", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Hash-only continuity bindings and succession attestations" }, "404": { "description": "Capsule not found" } } } }, "/api/v1/continuity/supersede": { "post": { "operationId": "supersede_continuity_capsule", "summary": "Supersede a Continuity Capsule™ without deleting history", "description": "Links an older capsule to a successor capsule and appends a continuity attestation. Historical data remains addressable.", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "capsule_id", "successor_capsule_id" ], "properties": { "capsule_id": { "type": "string", "format": "uuid" }, "successor_capsule_id": { "type": "string", "format": "uuid" }, "reason": { "type": "string" } } } } } }, "responses": { "200": { "description": "Append-only supersession linked" }, "409": { "description": "Capsule already superseded or successor conflict" } } } }, "/api/v1/continuity/export": { "post": { "operationId": "export_continuity_archive", "summary": "Export a portable Continuity Capsule™ archive", "description": "Exports an agentproof.continuity-archive/1 bundle with private tenant-visible capsule fields, closure, attestations, correction lineage, verification profile, and archive digest suite. Hash verification can be performed offline.", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "capsule_id" ], "properties": { "capsule_id": { "type": "string", "format": "uuid" } } } } } }, "responses": { "200": { "description": "Portable continuity archive" } } } } }, "x-agentproof-standard": { "name": "Agent Transaction Passport™", "abbreviation": "ATP", "version": "0.1", "specification": "https://agentproof.hatchable.site/standards/agent-transaction-passport-v0.1.md", "schema": "https://agentproof.hatchable.site/standards/agent-transaction-passport-v0.1.schema.json" }, "x-agentproof-trust": { "manifest": "https://agentproof.hatchable.site/.well-known/agentproof-trust.json", "current_resolution_protocol": "agentproof.resolution/0.2", "supported_resolution_protocols": [ "agentproof.resolution/0.1", "agentproof.resolution/0.2" ], "policy": "https://agentproof.hatchable.site/api/resolution/policy", "constitution": "https://agentproof.hatchable.site/standards/CONSTITUTION.md", "millennium_architecture": "https://agentproof.hatchable.site/standards/MILLENNIUM-ARCHITECTURE.md" }, "x-customer-acquisition": { "customer_fit": "https://agentproof.hatchable.site/.well-known/customer-fit.json", "sandbox": "https://agentproof.hatchable.site/sandbox/", "developers": "https://agentproof.hatchable.site/developers/", "enterprise": "https://agentproof.hatchable.site/enterprise/", "partners": "https://agentproof.hatchable.site/partners/", "roi": "https://agentproof.hatchable.site/roi/", "integration_kit": "https://agentproof.hatchable.site/integration-kit.md", "trust_checklist": "https://agentproof.hatchable.site/trust-checklist.md" }, "x-century-trust": { "specification": "https://agentproof.hatchable.site/standards/CENTURY-TRUST-LAYER.md", "consequence_boundary_protocol": "agentproof.consequence-boundary/1", "continuity_capsule_protocol": "agentproof.continuity-capsule/1", "invariant": "Authorization can permit an action. It cannot authorize unlimited consequence.", "digest_suite": [ "sha-256", "sha-512" ], "append_only_reattestation": true, "append_only_correction": true, "portable_archive": true, "offline_hash_verifiable": true } }