{ "openapi": "3.1.0", "info": { "title": "Santismm Knowledge Platform API", "version": "1.0.0", "summary": "Public, read-only, unauthenticated knowledge on harness engineering and agentic AI.", "description": "Every endpoint is a GET, needs no key, and answers with `Access-Control-Allow-Origin: *`.\n\nPrefer the Model Context Protocol endpoint at `/mcp` if your client speaks it: it carries the\nsame corpus with typed results, search and graph traversal. This document is for everything else.\n\nContent is CC-BY-4.0 — reuse it, credit the author, and link the canonical URL that\nevery entry carries.", "license": { "name": "CC-BY-4.0", "url": "https://creativecommons.org/licenses/by/4.0/" }, "contact": { "name": "Santiago Santa María", "url": "https://santismm.com/en/about" } }, "servers": [ { "url": "https://santismm.com" } ], "tags": [ { "name": "knowledge", "description": "Concepts on agentic and enterprise AI." }, { "name": "patterns", "description": "Reusable agentic design patterns." }, { "name": "architectures", "description": "End-to-end reference architectures." }, { "name": "governance", "description": "Regulations, standards and playbooks." }, { "name": "handbook", "description": "The long-form Harness Engineering Handbook." }, { "name": "graph", "description": "The corpus as nodes and edges." }, { "name": "matrix", "description": "The Agentic Control Matrix." }, { "name": "taxonomy", "description": "Comparable taxonomy of real AI agents." }, { "name": "homeric-atlas", "description": "Where the episodes of the Iliad and the Odyssey might have happened. Its own vocabulary: an identification class and a 0–12 rubric rather than Evidence-First provenance." }, { "name": "discovery", "description": "Manifests that point at everything else." } ], "paths": { "/api/knowledge": { "get": { "operationId": "list_knowledge", "summary": "List every knowledge unit", "description": "Concepts on agentic and enterprise AI. 23 units at the time this document was generated.", "tags": [ "knowledge" ], "responses": { "200": { "description": "Every unit, with full locale bodies.", "content": { "application/json": { "schema": { "type": "object", "properties": { "generated": { "type": "string", "format": "date-time" }, "count": { "type": "integer" }, "license_spdx": { "type": "string" }, "entries": { "type": "array", "items": { "type": "object", "properties": { "slug": { "type": "string" }, "id": { "type": "string", "description": "Present on architectures (ARCH-) and governance (GOV-)." }, "category": { "type": "string" }, "updated": { "type": "string", "format": "date" }, "version": { "type": "string" }, "url": { "type": "string", "format": "uri", "description": "Canonical page. Alias of canonical_url." }, "canonical_url": { "type": "string", "format": "uri", "description": "Cite this URL. Same name the MCP surface uses." }, "api_url": { "type": "string", "format": "uri" }, "evidence": { "type": "object", "description": "Evidence-First provenance. Every unit declares how well supported it is.", "properties": { "evidenceLevel": { "type": "string", "enum": [ "production", "simulation", "benchmark", "industry_observation", "theoretical" ] }, "confidenceLevel": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sourceType": { "type": "array", "items": { "type": "string" } } }, "required": [ "evidenceLevel", "confidenceLevel", "sourceType" ] }, "references": { "type": "array", "items": { "type": "object" } }, "related": { "type": "array", "items": { "type": "string" } }, "locales": { "type": "object", "description": "Full body per locale (en, es, pt, fr, de, ja, zh).", "additionalProperties": { "type": "object" } } }, "required": [ "slug", "category", "updated", "version", "canonical_url", "api_url", "evidence" ] } } }, "required": [ "count", "entries" ] } } } } } } }, "/api/knowledge/{slug}": { "get": { "operationId": "get_knowledge", "summary": "One knowledge unit", "tags": [ "knowledge" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "maxLength": 128 }, "example": "agent-memory" } ], "responses": { "200": { "description": "The unit, with every locale.", "content": { "application/json": { "schema": { "type": "object", "properties": { "slug": { "type": "string" }, "id": { "type": "string", "description": "Present on architectures (ARCH-) and governance (GOV-)." }, "category": { "type": "string" }, "updated": { "type": "string", "format": "date" }, "version": { "type": "string" }, "url": { "type": "string", "format": "uri", "description": "Canonical page. Alias of canonical_url." }, "canonical_url": { "type": "string", "format": "uri", "description": "Cite this URL. Same name the MCP surface uses." }, "api_url": { "type": "string", "format": "uri" }, "evidence": { "type": "object", "description": "Evidence-First provenance. Every unit declares how well supported it is.", "properties": { "evidenceLevel": { "type": "string", "enum": [ "production", "simulation", "benchmark", "industry_observation", "theoretical" ] }, "confidenceLevel": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sourceType": { "type": "array", "items": { "type": "string" } } }, "required": [ "evidenceLevel", "confidenceLevel", "sourceType" ] }, "references": { "type": "array", "items": { "type": "object" } }, "related": { "type": "array", "items": { "type": "string" } }, "locales": { "type": "object", "description": "Full body per locale (en, es, pt, fr, de, ja, zh).", "additionalProperties": { "type": "object" } } }, "required": [ "slug", "category", "updated", "version", "canonical_url", "api_url", "evidence" ] } } } }, "404": { "description": "No unit with that identifier.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "const": "not_found" }, "slug": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/patterns": { "get": { "operationId": "list_patterns", "summary": "List every patterns unit", "description": "Reusable agentic design patterns. 21 units at the time this document was generated.", "tags": [ "patterns" ], "responses": { "200": { "description": "Every unit, with full locale bodies.", "content": { "application/json": { "schema": { "type": "object", "properties": { "generated": { "type": "string", "format": "date-time" }, "count": { "type": "integer" }, "license_spdx": { "type": "string" }, "entries": { "type": "array", "items": { "type": "object", "properties": { "slug": { "type": "string" }, "id": { "type": "string", "description": "Present on architectures (ARCH-) and governance (GOV-)." }, "category": { "type": "string" }, "updated": { "type": "string", "format": "date" }, "version": { "type": "string" }, "url": { "type": "string", "format": "uri", "description": "Canonical page. Alias of canonical_url." }, "canonical_url": { "type": "string", "format": "uri", "description": "Cite this URL. Same name the MCP surface uses." }, "api_url": { "type": "string", "format": "uri" }, "evidence": { "type": "object", "description": "Evidence-First provenance. Every unit declares how well supported it is.", "properties": { "evidenceLevel": { "type": "string", "enum": [ "production", "simulation", "benchmark", "industry_observation", "theoretical" ] }, "confidenceLevel": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sourceType": { "type": "array", "items": { "type": "string" } } }, "required": [ "evidenceLevel", "confidenceLevel", "sourceType" ] }, "references": { "type": "array", "items": { "type": "object" } }, "related": { "type": "array", "items": { "type": "string" } }, "locales": { "type": "object", "description": "Full body per locale (en, es, pt, fr, de, ja, zh).", "additionalProperties": { "type": "object" } } }, "required": [ "slug", "category", "updated", "version", "canonical_url", "api_url", "evidence" ] } } }, "required": [ "count", "entries" ] } } } } } } }, "/api/patterns/{slug}": { "get": { "operationId": "get_patterns", "summary": "One patterns unit", "tags": [ "patterns" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "maxLength": 128 }, "example": "attributed-memory" } ], "responses": { "200": { "description": "The unit, with every locale.", "content": { "application/json": { "schema": { "type": "object", "properties": { "slug": { "type": "string" }, "id": { "type": "string", "description": "Present on architectures (ARCH-) and governance (GOV-)." }, "category": { "type": "string" }, "updated": { "type": "string", "format": "date" }, "version": { "type": "string" }, "url": { "type": "string", "format": "uri", "description": "Canonical page. Alias of canonical_url." }, "canonical_url": { "type": "string", "format": "uri", "description": "Cite this URL. Same name the MCP surface uses." }, "api_url": { "type": "string", "format": "uri" }, "evidence": { "type": "object", "description": "Evidence-First provenance. Every unit declares how well supported it is.", "properties": { "evidenceLevel": { "type": "string", "enum": [ "production", "simulation", "benchmark", "industry_observation", "theoretical" ] }, "confidenceLevel": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sourceType": { "type": "array", "items": { "type": "string" } } }, "required": [ "evidenceLevel", "confidenceLevel", "sourceType" ] }, "references": { "type": "array", "items": { "type": "object" } }, "related": { "type": "array", "items": { "type": "string" } }, "locales": { "type": "object", "description": "Full body per locale (en, es, pt, fr, de, ja, zh).", "additionalProperties": { "type": "object" } } }, "required": [ "slug", "category", "updated", "version", "canonical_url", "api_url", "evidence" ] } } } }, "404": { "description": "No unit with that identifier.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "const": "not_found" }, "slug": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/architectures": { "get": { "operationId": "list_architectures", "summary": "List every architectures unit", "description": "End-to-end reference architectures. 5 units at the time this document was generated.", "tags": [ "architectures" ], "responses": { "200": { "description": "Every unit, with full locale bodies.", "content": { "application/json": { "schema": { "type": "object", "properties": { "generated": { "type": "string", "format": "date-time" }, "count": { "type": "integer" }, "license_spdx": { "type": "string" }, "entries": { "type": "array", "items": { "type": "object", "properties": { "slug": { "type": "string" }, "id": { "type": "string", "description": "Present on architectures (ARCH-) and governance (GOV-)." }, "category": { "type": "string" }, "updated": { "type": "string", "format": "date" }, "version": { "type": "string" }, "url": { "type": "string", "format": "uri", "description": "Canonical page. Alias of canonical_url." }, "canonical_url": { "type": "string", "format": "uri", "description": "Cite this URL. Same name the MCP surface uses." }, "api_url": { "type": "string", "format": "uri" }, "evidence": { "type": "object", "description": "Evidence-First provenance. Every unit declares how well supported it is.", "properties": { "evidenceLevel": { "type": "string", "enum": [ "production", "simulation", "benchmark", "industry_observation", "theoretical" ] }, "confidenceLevel": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sourceType": { "type": "array", "items": { "type": "string" } } }, "required": [ "evidenceLevel", "confidenceLevel", "sourceType" ] }, "references": { "type": "array", "items": { "type": "object" } }, "related": { "type": "array", "items": { "type": "string" } }, "locales": { "type": "object", "description": "Full body per locale (en, es, pt, fr, de, ja, zh).", "additionalProperties": { "type": "object" } } }, "required": [ "slug", "category", "updated", "version", "canonical_url", "api_url", "evidence" ] } } }, "required": [ "count", "entries" ] } } } } } } }, "/api/architectures/{slug}": { "get": { "operationId": "get_architectures", "summary": "One architectures unit", "tags": [ "architectures" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "maxLength": 128 }, "example": "customer-service-agent" } ], "responses": { "200": { "description": "The unit, with every locale.", "content": { "application/json": { "schema": { "type": "object", "properties": { "slug": { "type": "string" }, "id": { "type": "string", "description": "Present on architectures (ARCH-) and governance (GOV-)." }, "category": { "type": "string" }, "updated": { "type": "string", "format": "date" }, "version": { "type": "string" }, "url": { "type": "string", "format": "uri", "description": "Canonical page. Alias of canonical_url." }, "canonical_url": { "type": "string", "format": "uri", "description": "Cite this URL. Same name the MCP surface uses." }, "api_url": { "type": "string", "format": "uri" }, "evidence": { "type": "object", "description": "Evidence-First provenance. Every unit declares how well supported it is.", "properties": { "evidenceLevel": { "type": "string", "enum": [ "production", "simulation", "benchmark", "industry_observation", "theoretical" ] }, "confidenceLevel": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sourceType": { "type": "array", "items": { "type": "string" } } }, "required": [ "evidenceLevel", "confidenceLevel", "sourceType" ] }, "references": { "type": "array", "items": { "type": "object" } }, "related": { "type": "array", "items": { "type": "string" } }, "locales": { "type": "object", "description": "Full body per locale (en, es, pt, fr, de, ja, zh).", "additionalProperties": { "type": "object" } } }, "required": [ "slug", "category", "updated", "version", "canonical_url", "api_url", "evidence" ] } } } }, "404": { "description": "No unit with that identifier.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "const": "not_found" }, "slug": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/governance": { "get": { "operationId": "list_governance", "summary": "List every governance unit", "description": "Regulations, standards and playbooks. 9 units at the time this document was generated.", "tags": [ "governance" ], "responses": { "200": { "description": "Every unit, with full locale bodies.", "content": { "application/json": { "schema": { "type": "object", "properties": { "generated": { "type": "string", "format": "date-time" }, "count": { "type": "integer" }, "license_spdx": { "type": "string" }, "entries": { "type": "array", "items": { "type": "object", "properties": { "slug": { "type": "string" }, "id": { "type": "string", "description": "Present on architectures (ARCH-) and governance (GOV-)." }, "category": { "type": "string" }, "updated": { "type": "string", "format": "date" }, "version": { "type": "string" }, "url": { "type": "string", "format": "uri", "description": "Canonical page. Alias of canonical_url." }, "canonical_url": { "type": "string", "format": "uri", "description": "Cite this URL. Same name the MCP surface uses." }, "api_url": { "type": "string", "format": "uri" }, "evidence": { "type": "object", "description": "Evidence-First provenance. Every unit declares how well supported it is.", "properties": { "evidenceLevel": { "type": "string", "enum": [ "production", "simulation", "benchmark", "industry_observation", "theoretical" ] }, "confidenceLevel": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sourceType": { "type": "array", "items": { "type": "string" } } }, "required": [ "evidenceLevel", "confidenceLevel", "sourceType" ] }, "references": { "type": "array", "items": { "type": "object" } }, "related": { "type": "array", "items": { "type": "string" } }, "locales": { "type": "object", "description": "Full body per locale (en, es, pt, fr, de, ja, zh).", "additionalProperties": { "type": "object" } } }, "required": [ "slug", "category", "updated", "version", "canonical_url", "api_url", "evidence" ] } } }, "required": [ "count", "entries" ] } } } } } } }, "/api/governance/{slug}": { "get": { "operationId": "get_governance", "summary": "One governance unit", "tags": [ "governance" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "maxLength": 128 }, "example": "eu-ai-act" } ], "responses": { "200": { "description": "The unit, with every locale.", "content": { "application/json": { "schema": { "type": "object", "properties": { "slug": { "type": "string" }, "id": { "type": "string", "description": "Present on architectures (ARCH-) and governance (GOV-)." }, "category": { "type": "string" }, "updated": { "type": "string", "format": "date" }, "version": { "type": "string" }, "url": { "type": "string", "format": "uri", "description": "Canonical page. Alias of canonical_url." }, "canonical_url": { "type": "string", "format": "uri", "description": "Cite this URL. Same name the MCP surface uses." }, "api_url": { "type": "string", "format": "uri" }, "evidence": { "type": "object", "description": "Evidence-First provenance. Every unit declares how well supported it is.", "properties": { "evidenceLevel": { "type": "string", "enum": [ "production", "simulation", "benchmark", "industry_observation", "theoretical" ] }, "confidenceLevel": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sourceType": { "type": "array", "items": { "type": "string" } } }, "required": [ "evidenceLevel", "confidenceLevel", "sourceType" ] }, "references": { "type": "array", "items": { "type": "object" } }, "related": { "type": "array", "items": { "type": "string" } }, "locales": { "type": "object", "description": "Full body per locale (en, es, pt, fr, de, ja, zh).", "additionalProperties": { "type": "object" } } }, "required": [ "slug", "category", "updated", "version", "canonical_url", "api_url", "evidence" ] } } } }, "404": { "description": "No unit with that identifier.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "const": "not_found" }, "slug": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/handbook": { "get": { "operationId": "list_handbook", "summary": "List every handbook chapter", "description": "The Harness Engineering Handbook. 14 chapters.", "tags": [ "handbook" ], "responses": { "200": { "description": "Chapter index.", "content": { "application/json": { "schema": { "type": "object", "properties": { "generated": { "type": "string", "format": "date-time" }, "license": { "type": "string" }, "license_spdx": { "type": "string" }, "license_url": { "type": "string", "format": "uri" }, "count": { "type": "integer" }, "units": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "slug": { "type": "string" }, "title": { "type": "string" }, "summary": { "type": "string" }, "updated": { "type": "string", "format": "date" }, "evidence": { "type": "object", "description": "Evidence-First provenance. Every unit declares how well supported it is.", "properties": { "evidenceLevel": { "type": "string", "enum": [ "production", "simulation", "benchmark", "industry_observation", "theoretical" ] }, "confidenceLevel": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sourceType": { "type": "array", "items": { "type": "string" } } }, "required": [ "evidenceLevel", "confidenceLevel", "sourceType" ] }, "url": { "type": "string", "format": "uri" }, "api": { "type": "string", "format": "uri" } }, "required": [ "id", "slug", "title", "summary", "updated", "evidence", "url", "api" ] } } }, "required": [ "generated", "count", "license", "license_spdx", "license_url", "units" ] } } } } } } }, "/api/handbook/{id}": { "get": { "operationId": "get_handbook", "summary": "One handbook chapter", "tags": [ "handbook" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "maxLength": 128 }, "example": "HRN-001" } ], "responses": { "200": { "description": "The chapter, body included.", "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string" }, "slug": { "type": "string" }, "title": { "type": "string" }, "category": { "type": "string" }, "status": { "type": "string" }, "summary": { "type": "string" }, "updated": { "type": "string", "format": "date" }, "url": { "type": "string", "format": "uri" }, "evidence": { "type": "object", "description": "Evidence-First provenance. Every unit declares how well supported it is.", "properties": { "evidenceLevel": { "type": "string", "enum": [ "production", "simulation", "benchmark", "industry_observation", "theoretical" ] }, "confidenceLevel": { "type": "string", "enum": [ "high", "medium", "low" ] }, "sourceType": { "type": "array", "items": { "type": "string" } } }, "required": [ "evidenceLevel", "confidenceLevel", "sourceType" ] }, "related": { "type": "array", "items": { "type": "string" } }, "tags": { "type": "array", "items": { "type": "string" } }, "headings": { "type": "array", "items": { "type": "string" } }, "markdown": { "type": "string" } }, "required": [ "id", "slug", "title", "category", "status", "summary", "updated", "url", "evidence", "related", "tags", "headings", "markdown" ] } } } }, "404": { "description": "No unit with that identifier.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "const": "not_found" }, "slug": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/graph.json": { "get": { "operationId": "get_graph", "summary": "The whole corpus as a graph", "description": "Nodes and typed edges across every domain — the cross-reference structure as data.", "tags": [ "graph" ], "responses": { "200": { "description": "Nodes and edges.", "content": { "application/json": { "schema": { "type": "object", "properties": { "generated": { "type": "string", "format": "date-time" }, "license": { "type": "string" }, "license_spdx": { "type": "string" }, "license_url": { "type": "string", "format": "uri" }, "nodeCount": { "type": "integer" }, "edgeCount": { "type": "integer" }, "edgeTypes": { "type": "object" }, "nodes": { "type": "array", "items": { "type": "object" } }, "edges": { "type": "array", "items": { "type": "object" } } }, "required": [ "generated", "license", "license_spdx", "license_url", "nodeCount", "edgeCount", "edgeTypes", "nodes", "edges" ] } } } } } } }, "/api/control-matrix": { "get": { "operationId": "get_control_matrix", "summary": "The Agentic Control Matrix", "description": "Agent controls mapped to the EU AI Act, ISO/IEC 42001, NIST AI RMF, OWASP and MITRE ATLAS.", "tags": [ "matrix" ], "responses": { "200": { "description": "Controls, frameworks and mappings.", "content": { "application/json": { "schema": { "type": "object", "properties": { "generated": { "type": "string", "format": "date-time" }, "license": { "type": "string" }, "license_spdx": { "type": "string" }, "license_url": { "type": "string", "format": "uri" }, "id": { "type": "string" }, "version": { "type": "string" }, "updated": { "type": "string", "format": "date" }, "url": { "type": "string", "format": "uri" }, "csv": { "type": "string", "format": "uri" }, "methodology": { "type": "object" }, "count": { "type": "integer" }, "groups": { "type": "array", "items": { "type": "string" } }, "axes": { "type": "object" }, "expiry": { "type": "object" }, "frameworks": { "type": "array", "items": { "type": "object" } }, "controls": { "type": "array", "items": { "type": "object" } } }, "required": [ "generated", "id", "version", "updated", "url", "csv", "license", "license_spdx", "license_url", "methodology", "count", "groups", "axes", "expiry", "frameworks", "controls" ] } } } } } } }, "/api/harness-scorecard": { "get": { "operationId": "get_harness_scorecard", "summary": "The Harness Scorecard", "description": "One formula and eleven metrics for comparing agent harnesses. Primary unit: cost per correctly verified outcome. An unvalidated proposal, and the payload says so.", "tags": [ "matrix" ], "responses": { "200": { "description": "The formula, the reporting requirements and every metric.", "content": { "application/json": { "schema": { "type": "object", "properties": { "generated": { "type": "string", "format": "date-time" }, "license": { "type": "string" }, "license_spdx": { "type": "string" }, "license_url": { "type": "string", "format": "uri" }, "id": { "type": "string" }, "version": { "type": "string" }, "updated": { "type": "string", "format": "date" }, "url": { "type": "string", "format": "uri" }, "status": { "type": "object" }, "primary": { "type": "string" }, "formula": { "type": "object" }, "reporting_required": { "type": "array", "items": { "type": "string" } }, "groups": { "type": "array", "items": { "type": "string" } }, "count": { "type": "integer" }, "metrics": { "type": "array", "items": { "type": "object" } } }, "required": [ "generated", "id", "version", "updated", "url", "license", "license_spdx", "license_url", "status", "primary", "formula", "reporting_required", "groups", "count", "metrics" ] } } } } } } }, "/api/harness-maturity": { "get": { "operationId": "get_harness_maturity", "summary": "The Harness Maturity Model", "description": "Seven levels from prompted to adaptive, each with criteria that can be passed or failed. Cumulative: a level is held only when everything at and below it passes.", "tags": [ "matrix" ], "responses": { "200": { "description": "The levels, their criteria and the composition rule.", "content": { "application/json": { "schema": { "type": "object", "properties": { "generated": { "type": "string", "format": "date-time" }, "license": { "type": "string" }, "license_spdx": { "type": "string" }, "license_url": { "type": "string", "format": "uri" }, "id": { "type": "string" }, "version": { "type": "string" }, "updated": { "type": "string", "format": "date" }, "url": { "type": "string", "format": "uri" }, "status": { "type": "object" }, "count": { "type": "integer" }, "criteria_count": { "type": "integer" }, "levels": { "type": "array", "items": { "type": "object" } } }, "required": [ "generated", "id", "version", "updated", "url", "license", "license_spdx", "license_url", "status", "count", "criteria_count", "levels" ] } } } } } } }, "/control-matrix.csv": { "get": { "operationId": "get_control_matrix_csv", "summary": "The Agentic Control Matrix as CSV", "tags": [ "matrix" ], "responses": { "200": { "description": "One row per control.", "content": { "text/csv": { "schema": { "type": "string" } } } } } } }, "/api/agent-taxonomy.json": { "get": { "operationId": "get_agent_taxonomy", "summary": "Taxonomy of real AI agents", "tags": [ "taxonomy" ], "responses": { "200": { "description": "Agents scored on the comparable vector.", "content": { "application/json": { "schema": { "type": "object", "properties": { "generated": { "type": "string", "format": "date-time" }, "license": { "type": "string" }, "license_spdx": { "type": "string" }, "license_url": { "type": "string", "format": "uri" }, "version": { "type": "string" }, "updated": { "type": "string", "format": "date" }, "description": { "type": "string" }, "page": { "type": "string", "format": "uri" }, "riskModel": { "type": "object" }, "axisModel": { "type": "object" }, "axes": { "type": "array", "items": { "type": "object" } }, "surfaces": { "type": "array", "items": { "type": "object" } }, "agents": { "type": "array", "items": { "type": "object" } }, "harnesses": { "type": "array", "items": { "type": "object" } } }, "required": [ "generated", "version", "updated", "license", "license_spdx", "license_url", "description", "page", "riskModel", "axisModel", "axes", "surfaces", "agents", "harnesses" ] } } } } } } }, "/api/homeric/places": { "get": { "operationId": "list_homeric_places", "summary": "List every Homeric Atlas place", "description": "Locations, each with the identifications proposed for it. 34 at the time this document was generated. Each carries an identification class (accepted · plausible · speculative · mythical) and a 0–12 rubric, not Evidence-First provenance.", "tags": [ "homeric-atlas" ], "responses": { "200": { "description": "Every places, with all seven locales.", "content": { "application/json": { "schema": { "type": "object", "properties": { "generated": { "type": "string", "format": "date-time" }, "license": { "type": "string" }, "license_spdx": { "type": "string" }, "license_url": { "type": "string", "format": "uri" }, "atlas": { "type": "string", "format": "uri" }, "methodology": { "type": "string", "format": "uri" }, "count": { "type": "integer" }, "rubric": { "type": "object" }, "places": { "type": "array", "items": { "type": "object" } } }, "required": [ "generated", "atlas", "methodology", "license", "license_spdx", "license_url", "count", "rubric", "places" ] } } } } } } }, "/api/homeric/places/{slug}": { "get": { "operationId": "get_homeric_place", "summary": "One Homeric Atlas place", "tags": [ "homeric-atlas" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "maxLength": 128 }, "example": "troy" } ], "responses": { "200": { "description": "The artifact, with every locale.", "content": { "application/json": { "schema": { "type": "object", "properties": { "generated": { "type": "string", "format": "date-time" }, "license": { "type": "string" }, "license_spdx": { "type": "string" }, "license_url": { "type": "string", "format": "uri" }, "atlas": { "type": "string", "format": "uri" }, "methodology": { "type": "string", "format": "uri" }, "rubric": { "type": "object" }, "place": { "type": "object" } }, "required": [ "generated", "atlas", "methodology", "license", "license_spdx", "license_url", "rubric", "place" ] } } } }, "404": { "description": "No unit with that identifier.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "const": "not_found" }, "slug": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/homeric/episodes": { "get": { "operationId": "list_homeric_episodes", "summary": "List every Homeric Atlas episode", "description": "Passages of the Iliad and the Odyssey, with the theories about where they happened. 24 at the time this document was generated. Each carries an identification class (accepted · plausible · speculative · mythical) and a 0–12 rubric, not Evidence-First provenance.", "tags": [ "homeric-atlas" ], "responses": { "200": { "description": "Every episodes, with all seven locales.", "content": { "application/json": { "schema": { "type": "object", "properties": { "generated": { "type": "string", "format": "date-time" }, "license": { "type": "string" }, "license_spdx": { "type": "string" }, "license_url": { "type": "string", "format": "uri" }, "atlas": { "type": "string", "format": "uri" }, "methodology": { "type": "string", "format": "uri" }, "count": { "type": "integer" }, "rubric": { "type": "object" }, "episodes": { "type": "array", "items": { "type": "object" } } }, "required": [ "generated", "atlas", "methodology", "license", "license_spdx", "license_url", "count", "rubric", "episodes" ] } } } } } } }, "/api/homeric/episodes/{slug}": { "get": { "operationId": "get_homeric_episode", "summary": "One Homeric Atlas episode", "tags": [ "homeric-atlas" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "maxLength": 128 }, "example": "chryse-and-the-plague" } ], "responses": { "200": { "description": "The artifact, with every locale.", "content": { "application/json": { "schema": { "type": "object", "properties": { "generated": { "type": "string", "format": "date-time" }, "license": { "type": "string" }, "license_spdx": { "type": "string" }, "license_url": { "type": "string", "format": "uri" }, "atlas": { "type": "string", "format": "uri" }, "methodology": { "type": "string", "format": "uri" }, "rubric": { "type": "object" }, "episode": { "type": "object" } }, "required": [ "generated", "atlas", "methodology", "license", "license_spdx", "license_url", "rubric", "episode" ] } } } }, "404": { "description": "No unit with that identifier.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "const": "not_found" }, "slug": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/homeric/routes": { "get": { "operationId": "list_homeric_routes", "summary": "List every Homeric Atlas route", "description": "Itineraries, with rival reconstructions scored separately. 4 at the time this document was generated. Each carries an identification class (accepted · plausible · speculative · mythical) and a 0–12 rubric, not Evidence-First provenance.", "tags": [ "homeric-atlas" ], "responses": { "200": { "description": "Every routes, with all seven locales.", "content": { "application/json": { "schema": { "type": "object", "properties": { "generated": { "type": "string", "format": "date-time" }, "license": { "type": "string" }, "license_spdx": { "type": "string" }, "license_url": { "type": "string", "format": "uri" }, "atlas": { "type": "string", "format": "uri" }, "methodology": { "type": "string", "format": "uri" }, "count": { "type": "integer" }, "rubric": { "type": "object" }, "routes": { "type": "array", "items": { "type": "object" } } }, "required": [ "generated", "atlas", "methodology", "license", "license_spdx", "license_url", "count", "rubric", "routes" ] } } } } } } }, "/api/homeric/routes/{slug}": { "get": { "operationId": "get_homeric_route", "summary": "One Homeric Atlas route", "tags": [ "homeric-atlas" ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "maxLength": 128 }, "example": "odysseus-nostos" } ], "responses": { "200": { "description": "The artifact, with every locale.", "content": { "application/json": { "schema": { "type": "object", "properties": { "generated": { "type": "string", "format": "date-time" }, "license": { "type": "string" }, "license_spdx": { "type": "string" }, "license_url": { "type": "string", "format": "uri" }, "atlas": { "type": "string", "format": "uri" }, "methodology": { "type": "string", "format": "uri" }, "rubric": { "type": "object" }, "route": { "type": "object" } }, "required": [ "generated", "atlas", "methodology", "license", "license_spdx", "license_url", "rubric", "route" ] } } } }, "404": { "description": "No unit with that identifier.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string", "const": "not_found" }, "slug": { "type": "string" } }, "required": [ "error" ] } } } } } } }, "/api/homeric-atlas.json": { "get": { "operationId": "get_homeric_atlas", "summary": "The whole Homeric Atlas in one fetch", "description": "Every place, hypothesis, episode and route with all seven locales, the 0–12 rubric that produced each score, the identification classes and the map frame.", "tags": [ "homeric-atlas" ], "responses": { "200": { "description": "The full corpus.", "content": { "application/json": { "schema": { "type": "object", "properties": { "generated": { "type": "string", "format": "date-time" }, "license": { "type": "string" }, "license_spdx": { "type": "string" }, "license_url": { "type": "string", "format": "uri" }, "atlas": { "type": "string", "format": "uri" }, "methodology": { "type": "string", "format": "uri" }, "description": { "type": "string" }, "counts": { "type": "object" }, "rubric": { "type": "object" }, "identification_classes": { "type": "object" }, "map_frame": { "type": "object" }, "geojson": { "type": "object" }, "band_for_score": { "type": "object" }, "places": { "type": "array", "items": { "type": "object" } }, "episodes": { "type": "array", "items": { "type": "object" } }, "routes": { "type": "array", "items": { "type": "object" } } }, "required": [ "generated", "atlas", "methodology", "license", "license_spdx", "license_url", "description", "counts", "rubric", "identification_classes", "map_frame", "geojson", "band_for_score", "places", "episodes", "routes" ] } } } } } } }, "/api/homeric/places.geojson": { "get": { "operationId": "get_homeric_places_geojson", "summary": "Atlas places as GeoJSON", "description": "One Point feature per identification, not per place, so rival candidacies survive the export. Places the poem does not locate carry no feature and are reported in `excluded` with the reason.", "tags": [ "homeric-atlas" ], "responses": { "200": { "description": "A FeatureCollection of points.", "content": { "application/geo+json": { "schema": { "type": "object" } } } } } } }, "/api/homeric/routes.geojson": { "get": { "operationId": "get_homeric_routes_geojson", "summary": "Atlas routes as GeoJSON", "description": "One LineString per reconstruction variant. Stops the variant does not place are dropped from the geometry and listed in `properties.skipped_stops`.", "tags": [ "homeric-atlas" ], "responses": { "200": { "description": "A FeatureCollection of line strings.", "content": { "application/geo+json": { "schema": { "type": "object" } } } } } } }, "/ai-index.json": { "get": { "operationId": "get_ai_index", "summary": "Discovery manifest for agents", "description": "One document pointing at every machine-readable surface this domain serves.", "tags": [ "discovery" ], "responses": { "200": { "description": "Surfaces, feeds and endpoints.", "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "description": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "updated": { "type": "string", "format": "date-time" }, "languages": { "type": "array", "items": { "type": "string" } }, "author": { "type": "object" }, "topics": { "type": "array", "items": { "type": "string" } }, "discovery": { "type": "object" }, "api": { "type": "object" }, "related_surfaces": { "type": "array", "items": { "type": "object" } }, "mcp": { "type": "object" }, "agent_skill": { "type": "object" }, "knowledge_base": { "type": "object" } }, "required": [ "name", "description", "url", "updated", "languages", "author", "topics", "discovery", "api", "related_surfaces", "mcp", "agent_skill", "knowledge_base" ] } } } } } } } } }