Developers

YAIBOS developer resources

Key data on this site is available in machine-readable form. The YAIBOS API is static and read-only: no account, no key, GET and HEAD only.

OpenAPI 3.1 description

Machine-readable description of every endpoint, response, and error format.

GET /api/v1/pillars.json

YAIBOS overview and the six architectural pillars.

GET /api/v1/implementations.json

The scorecard: criteria, grades, scores from 0 to 5, strengths, and gaps for each tool.

Homepage in Markdown

Also returned by the homepage itself when a request sends Accept: text/markdown.

llms.txt

Site summary and guidance for AI agents.

Errors

Unknown /api/ paths return HTTP 404 and write methods return HTTP 405, both as JSON with a stable code, a message, and a hint. Unknown pages return HTTP 404, as Markdown when the request sends Accept: text/markdown.

{
  "error": {
    "status": 404,
    "code": "not_found",
    "message": "No API endpoint at /api/v1/unknown.",
    "hint": "See https://yaibos.com/openapi.json for available endpoints.",
    "docs": "https://yaibos.com/openapi.json"
  }
}