{"openapi":"3.1.0","info":{"title":"Vibe Haus public research API","version":"1.0.0","description":"Retrieve published engineering research and instruction templates. No authentication, writes, code execution, or private customer data. MCP clients use the separate Streamable HTTP endpoint /mcp documented at /data."},"servers":[{"url":"https://vibehaus.team"}],"security":[],"externalDocs":{"description":"Usage, MCP tools, source policy, and downloads","url":"https://vibehaus.team/data"},"paths":{"/api/research":{"get":{"operationId":"getResearchCatalog","summary":"Read the published research catalog","description":"Returns the complete public catalog, including article sections, citations, Markdown, canonical URLs, and update date. No parameters or authentication. Drafts are excluded.","responses":{"200":{"description":"Published research catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResearchCatalog"}}}}}}},"/blog/{slug}/article.md":{"get":{"operationId":"getResearchArticleMarkdown","summary":"Read a published research article as Markdown","description":"Read-only public download. No API key is required. Only published resources are available.","parameters":[{"name":"slug","in":"path","required":true,"description":"Published slug identifier.","schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"example":"agentic-code-factory"}],"responses":{"200":{"description":"Read a published research article as Markdown","content":{"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"Unknown resource. The response is plain text or the framework HTML 404 page."}}}},"/skills/{slug}/SKILL.md":{"get":{"operationId":"getEngineeringSkill","summary":"Download an engineering instruction template","description":"Read-only public download. No API key is required. Only published resources are available.","parameters":[{"name":"slug","in":"path","required":true,"description":"Published slug identifier.","schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"example":"engineering-task-contract"}],"responses":{"200":{"description":"Download an engineering instruction template","content":{"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"Unknown resource. The response is plain text or the framework HTML 404 page."}}}}},"components":{"schemas":{"Article":{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"topic":{"type":"string"},"date":{"type":"string","format":"date"},"updated":{"type":"string","format":"date"},"thesis":{"type":"string"},"sections":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"paragraphs":{"type":"array","items":{"type":"string"}},"bullets":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"string"}},"code":{"type":"object","properties":{"language":{"type":"string"},"text":{"type":"string"}},"required":["language","text"]},"table":{"type":"object","properties":{"columns":{"type":"array","items":{"type":"string"}},"rows":{"type":"array","items":{"type":"array","items":{"type":"string"}}}},"required":["columns","rows"]},"flow":{"type":"object","properties":{"caption":{"type":"string"},"steps":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"detail":{"type":"string"}},"required":["title","detail"]}},"gate":{"type":"string"},"pass":{"type":"string"},"fail":{"type":"string"}},"required":["caption","steps","gate","pass","fail"]}},"required":["id","title","paragraphs"]}},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"author":{"type":"string"},"url":{"type":"string","format":"uri"},"kind":{"type":"string"}},"required":["id","title","author","url","kind"]}},"url":{"type":"string","format":"uri"},"markdownUrl":{"type":"string","format":"uri"},"markdown":{"type":"string"}},"required":["slug","title","description","topic","date","thesis","sections","sources","url","markdownUrl","markdown"]},"ResearchCatalog":{"type":"object","properties":{"schemaVersion":{"type":"string","const":"1.0"},"updated":{"type":"string","format":"date"},"publisher":{"type":"string"},"method":{"type":"string"},"url":{"type":"string","format":"uri"},"mcp":{"type":"string","format":"uri"},"articles":{"type":"array","items":{"$ref":"#/components/schemas/Article"}}},"required":["schemaVersion","updated","publisher","method","url","mcp","articles"]},"Problem":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"documentation":{"type":"string","format":"uri"}},"required":["type","title","status","code","detail","documentation"]}}},"x-errors":{"unknown-api-path":{"description":"The requested published resource does not exist.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}