{"openapi":"3.1.1","info":{"title":"MantrixFlow Public Discovery API","version":"1.0.0","summary":"Read-only discovery for MantrixFlow agents and integrations.","description":"This API describes MantrixFlow and its currently published agent-facing interfaces. It does not control customer pipelines and does not expose the authenticated product API.","termsOfService":"https://mantrixflow.com/terms","contact":{"name":"MantrixFlow Support","url":"https://mantrixflow.com/contact","email":"support@mantrixflow.com"}},"jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","servers":[{"url":"https://mantrixflow.com","description":"Production marketing origin"}],"security":[],"externalDocs":{"description":"MantrixFlow developer and agent guide","url":"https://mantrixflow.com/developers"},"tags":[{"name":"Discovery","description":"Unauthenticated, read-only product discovery operations."}],"paths":{"/api":{"get":{"operationId":"getDiscoveryIndex","tags":["Discovery"],"summary":"Get discovery links","description":"Returns canonical links for the OpenAPI document, capability manifest, health endpoint, and developer guide.","responses":{"200":{"description":"Canonical discovery links.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiscoveryIndex"}}}},"405":{"description":"The request could not be completed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/health":{"get":{"operationId":"getHealth","tags":["Discovery"],"summary":"Check discovery API health","description":"Checks only the public discovery surface on mantrixflow.com; it is not a health check for customer pipeline execution.","responses":{"200":{"description":"The discovery API is available.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}}},"405":{"description":"The request could not be completed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/agent-capabilities":{"get":{"operationId":"getAgentCapabilities","tags":["Discovery"],"summary":"Get agent-facing capabilities","description":"Returns machine-readable availability for Markdown negotiation, discovery files, product API access, OAuth, MCP, CLI, and agent sandbox interfaces.","responses":{"200":{"description":"Current MantrixFlow agent-facing capability manifest.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentCapabilities"}}}},"405":{"description":"The request could not be completed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"DiscoveryIndex":{"type":"object","additionalProperties":false,"required":["service","version","documentation","openapi","capabilities","health"],"properties":{"service":{"type":"string"},"version":{"type":"string"},"documentation":{"type":"string","format":"uri"},"openapi":{"type":"string","format":"uri"},"capabilities":{"type":"string","format":"uri"},"health":{"type":"string","format":"uri"}}},"Health":{"type":"object","additionalProperties":false,"required":["status","service","version","timestamp"],"properties":{"status":{"type":"string","const":"ok"},"service":{"type":"string"},"version":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}},"AgentCapabilities":{"type":"object","description":"Current discovery and product-access capabilities. False values are explicit availability boundaries.","required":["schema_version","name","canonical_url","discovery","public_api","product_access","contact"],"properties":{"schema_version":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"canonical_url":{"type":"string","format":"uri"},"updated_at":{"type":"string","format":"date"},"discovery":{"type":"object","additionalProperties":true},"public_api":{"type":"object","additionalProperties":true},"product_access":{"type":"object","additionalProperties":true},"contact":{"type":"object","additionalProperties":true}}},"RecoveryLink":{"type":"object","additionalProperties":false,"required":["label","href"],"properties":{"label":{"type":"string"},"href":{"type":"string","format":"uri"}}},"ErrorResponse":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","status","recovery"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"recovery":{"type":"array","items":{"$ref":"#/components/schemas/RecoveryLink"}}}}}}}},"x-agent-guidance":{"purpose":"Use these operations to discover MantrixFlow resources and capability boundaries.","authentication":"No authentication is required.","side_effects":"All documented operations are read-only.","product_api_notice":"No public pipeline-control API, OAuth authorization server, MCP server, CLI, or agent sandbox is currently published."}}