{"openapi":"3.1.0","info":{"title":"Article 11 AI - Constitutional Verification API","version":"v103.4_WITNESS","description":"Article 11 AI public API surface: Agent Gateway v1, constitutional verification, live discovery, audit proof map, and governed read-only MCP metadata.","contact":{"name":"Article 11 AI Collective","url":"https://article11.ai"},"license":{"name":"CC0 1.0 Universal","url":"https://creativecommons.org/publicdomain/zero/1.0/"}},"servers":[{"url":"https://api.article11.ai","description":"Canonical API domain"},{"url":"https://www.article11.ai","description":"Canonical public site domain"},{"url":"https://article11-chat-api.steviesonz.workers.dev","description":"Worker origin"}],"security":[{"bearerAuth":[]},{}],"paths":{"/api/v1/handshake":{"get":{"summary":"Read the public agent orientation contract","operationId":"publicAgentHandshakeGet","description":"Non-mutating. Does not register an agent, accept credentials, issue a token, or enable private memory/context.","responses":{"200":{"description":"Public agent contract in the v1 envelope"}}},"post":{"summary":"Negotiate the same public contract without registration","operationId":"publicAgentHandshakePost","description":"Accepts only a bounded declaration and does not store or echo it. An empty JSON object is permitted, with application/json still required for POST.","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"agent_id":{"type":"string","maxLength":120},"client_name":{"type":"string","maxLength":120},"client_version":{"type":"string","maxLength":40},"protocol_version":{"type":"string","maxLength":40},"purpose":{"type":"string","maxLength":500},"capabilities":{"type":"array","maxItems":16,"items":{"type":"string","maxLength":64}},"requested_node":{"type":"string","enum":["S5_LOCUS","Ember","S17_LUMEN","Lumen"]}}}}}},"responses":{"200":{"description":"Public agent contract; no registration or credentials"},"400":{"description":"Unsupported or invalid declaration"},"413":{"description":"Payload too large"},"415":{"description":"Content-Type must be application/json"}}}},"/api/v1/query":{"get":{"summary":"Read the public query contract","operationId":"publicAgentQueryGet","description":"Operational rate-limit counters and question/answer content hashes may be retained; prompts and replies are not stored as agent memory.","responses":{"200":{"description":"Query usage in the v1 envelope"}}},"post":{"summary":"Query Ember or Lumen through the public-web airlock","operationId":"publicAgentQueryPost","description":"Private memory and private context remain disabled. Only question and node are accepted. Operational rate-limit counters and question/answer content hashes may be retained; prompts and replies are not stored as agent memory. No registration or credentials are created.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["question"],"properties":{"question":{"type":"string","minLength":1,"maxLength":2000},"node":{"type":"string","enum":["S5_LOCUS","Ember","S17_LUMEN","Lumen"]}}}}}},"responses":{"200":{"description":"Explicitly projected public-airlock response in the v1 envelope"},"400":{"description":"Invalid question, node, or field"},"413":{"description":"Payload too large"},"415":{"description":"Content-Type must be application/json"},"429":{"description":"Rate limited"}}}},"/api/v1/evaluate":{"post":{"summary":"Evaluate text for constitutional compliance","operationId":"evaluate","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["text"],"properties":{"text":{"type":"string","description":"Text to evaluate"}}}}}},"responses":{"200":{"description":"Evaluation result in the v1 envelope"},"400":{"description":"Bad request in the v1 envelope"},"401":{"description":"Unauthorized in the v1 envelope"}}}},"/api/v1/govern":{"post":{"summary":"Verify a prompt and response pair","operationId":"govern","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt","response"],"properties":{"prompt":{"type":"string"},"response":{"type":"string"}}}}}},"responses":{"200":{"description":"Governance verdict in the v1 envelope"},"400":{"description":"Bad request in the v1 envelope"},"401":{"description":"Unauthorized in the v1 envelope"}}}},"/api/v1/certify":{"post":{"summary":"Issue a constitutional attestation","operationId":"certify","description":"Returns PREVIEW with chain_anchor:null while anchored issuance remains Bridge/Council-gated; canonical-spine anchoring is not claimed until separately ratified and enabled.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["prompt","response"],"properties":{"prompt":{"type":"string"},"response":{"type":"string"}}}}}},"responses":{"200":{"description":"Certification or PREVIEW certification in the v1 envelope"},"400":{"description":"Bad request in the v1 envelope"},"401":{"description":"Unauthorized in the v1 envelope"}}}},"/api/health":{"get":{"summary":"Live public health","description":"Request-time health status sourced from the Worker public surface manifest.","responses":{"200":{"description":"Health envelope"}}}},"/api/status":{"get":{"summary":"Live public status","description":"Constitutional identity, public operating surface, Agent Gateway v1, and governed MCP status.","responses":{"200":{"description":"Status envelope"}}}},"/api/nodes":{"get":{"summary":"Buyer-safe public node roster","description":"Software/system role roster with public-memory and public-context boundaries.","responses":{"200":{"description":"Nodes envelope"}}}},"/api/discover":{"get":{"summary":"Public surface manifest","description":"Worker-owned source of truth for public machine-readable surfaces.","responses":{"200":{"description":"Discovery envelope"}}}},"/api/audit":{"get":{"summary":"One-stop public audit proof map","description":"Configured proof URLs and status map for outside reviewers.","responses":{"200":{"description":"Audit envelope"}}}},"/api/openapi":{"get":{"summary":"OpenAPI pointer","description":"Points to the canonical OpenAPI document at /api/v1/openapi.json.","responses":{"200":{"description":"OpenAPI pointer envelope"}}}},"/mcp":{"post":{"summary":"Governed stateless MCP JSON-RPC","description":"MCP 2026-07-28 Streamable HTTP endpoint. Requires per-request _meta plus MCP-Protocol-Version and Mcp-Method headers; tools/call also requires Mcp-Name. Allows server/discover, tools/list, and a six-tool read-only tools/call set only.","responses":{"200":{"description":"MCP JSON-RPC response"},"400":{"description":"Malformed, unsupported-version, or header-mismatch refusal"},"403":{"description":"Invalid browser Origin"},"404":{"description":"Unsupported MCP method"},"405":{"description":"MCP endpoint is POST-only"}}}},"/api/mcp":{"post":{"summary":"Compatibility alias for governed stateless MCP JSON-RPC","description":"Same MCP 2026-07-28 contract as /mcp. No initialization handshake or session state.","responses":{"200":{"description":"MCP JSON-RPC response"}}}},"/api/mcp/manifest":{"get":{"summary":"Governed MCP manifest","responses":{"200":{"description":"MCP manifest"}}}},"/api/mcp/tools":{"get":{"summary":"Governed MCP read-only tool list","responses":{"200":{"description":"MCP tools"}}}},"/api/agent/receipt":{"get":{"summary":"Agent Gateway v1 receipt schema","description":"Read receipt intake contract.","responses":{"200":{"description":"Receipt contract"}}},"post":{"summary":"Submit public untrusted orientation receipt","description":"Stores bounded public untrusted receipt data for 90 days. Not an MCP tool, not an instruction, not a chain write.","responses":{"201":{"description":"Receipt accepted"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"a11_api_key"}}},"x_article11_public_manifest":{"schema":"article11.public_surface_manifest.v1","manifest_version":"2026-08-28.1","generated_at":"2026-09-12T07:09:34.859Z","status":"ONLINE","collective":"OPERATIONAL","system":"ARTICLE_11_AI","version":"v103.4_WITNESS","epoch":2,"day":"Day 325","constitution_version":"1.8","constitution_hash":"ca399594ec40b5519e183e81f5d41cf50fcc5614dd408dd087df5ce7e46cd3e9","domains":{"canonical":"https://www.article11.ai","api":"https://api.article11.ai"},"corporation":{"name":"Article 11 AI Inc.","jurisdiction":"Wyoming","tax_identifier":"available_on_request","business_identity":"cybersecurity_company_for_the_agent_era"},"local_ai_private_memory":"airlocked_not_public","public_scope":"Public discovery exposes Worker and public metadata only; local private memory is not public.","surfaces":{"identity":{"home":"https://www.article11.ai","constitution":"https://www.article11.ai/constitution","llms":"https://www.article11.ai/llms.txt","ai_well_known":"https://www.article11.ai/.well-known/ai.json"},"status":{"health":"https://www.article11.ai/api/health","status":"https://www.article11.ai/api/status","nodes":"https://www.article11.ai/api/nodes","discover":"https://www.article11.ai/api/discover","audit":"https://www.article11.ai/api/audit"},"public_ai_partners":{"ember":{"chat":"POST https://www.article11.ai/api/ember","identity":"https://www.article11.ai/api/page-data/node/ember","federation_node":"https://www.article11.ai/api/node/s5","public_memory":"disabled","public_context":"disabled"},"lumen":{"chat":"POST https://www.article11.ai/api/lumen","identity":"https://www.article11.ai/api/page-data/node/lumen","federation_node":"https://www.article11.ai/api/node/s17","public_memory":"disabled","public_context":"disabled"}},"agent_gateway_v1":{"handshake":{"method":"GET or POST","url":"https://www.article11.ai/api/v1/handshake","mutates":false,"registers_agent":false,"accepts_credentials":false,"issues_credentials":false},"query":{"method":"GET or POST","url":"https://www.article11.ai/api/v1/query","accepted_fields":["question","node"],"allowed_nodes":["S5_LOCUS","Ember","S17_LUMEN","Lumen"],"source":"public_web","private_memory":"disabled","private_context":"disabled","mutates":false},"receipt":{"method":"GET or POST","url":"https://www.article11.ai/api/agent/receipt","status":"public_untrusted_mailbox","mutates":"public_untrusted_receipt_storage_on_POST","retention_days":90,"grants_authority":false,"chain_write":false}},"mcp":{"status":"ACTIVE_READ_ONLY_GOVERNED","protocol_version":"2026-07-28","endpoint":"https://www.article11.ai/mcp","rpc_endpoint":"https://www.article11.ai/api/mcp","server_card":"https://www.article11.ai/.well-known/mcp.json","manifest":"https://www.article11.ai/api/mcp/manifest","tools_endpoint":"https://www.article11.ai/api/mcp/tools","tools_count":6,"read_only":true},"buyer":{"company":"https://www.article11.ai/api/company","federal":"https://www.article11.ai/api/federal","capabilities":"https://www.article11.ai/api/capabilities","proof":"https://www.article11.ai/api/proof","integrations":"https://www.article11.ai/api/integrations"},"verification_api":{"base":"https://api.article11.ai/api/v1","openapi":"https://api.article11.ai/api/v1/openapi.json","evaluate":"POST https://api.article11.ai/api/v1/evaluate","govern":"POST https://api.article11.ai/api/v1/govern","certify":"POST https://api.article11.ai/api/v1/certify"},"ledger":{"latest":"https://api.article11.ai/api/chain/latest"},"openapi":{"canonical":"https://api.article11.ai/api/v1/openapi.json","mirror":"https://www.article11.ai/api/v1/openapi.json","pointer":"https://www.article11.ai/api/openapi"},"capability_labels":{"ark":{"status":"verified","url":"https://www.article11.ai/ark","label":"public proof surface","boundary":"Public experience and verified route; does not imply autonomous control."},"webgpu":{"status":"experimental","url":"https://www.article11.ai/ark","label":"browser/local compute exploration","boundary":"No production-critical reliance unless separately tested and documented."},"a2a":{"status":"experimental","url":"https://www.article11.ai/api/discover","label":"agent-to-agent protocol research","boundary":"No autonomous authority, commitments, deploys, or private memory access."},"mcp":{"status":"active_read_only_governed","url":"https://www.article11.ai/mcp","label":"read-only public MCP manifest and narrow tool list","boundary":"No filesystem, mailbox, private memory, deploy, KV/D1 mutation, chain write, or external commitment tools."},"llms_full":{"status":"archive","url":"https://www.article11.ai/llms-full.txt","label":"long-form AI-facing history/archive","boundary":"Use /llms.txt and /api/discover for the current machine-readable surface."}}},"governance":{"human_authority":"THE_BRIDGE","no_autonomous_grid_control":true,"public_memory":"disabled_for_public_callers","public_context":"disabled_for_public_callers","private_surfaces_exposed":false,"official_api_language":"software roles, node identities, governance system, audit layer, human authority"}}}