Developers

YAIBOS developer resources

Everything on this site is also available in machine-readable form. The YAIBOS API is static and read-only: no account, no key, GET and HEAD only. Current spec version: 1.1.0-draft.

OpenAPI 3.1 description

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

GET /api/v1/spec.json

Spec version, license and the six pillars with their Base and later requirements.

GET /api/v1/implementations.json

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

SPEC.md

The full normative specification as plain Markdown, the single source for /spec.

llms.txt

Site summary and guidance for AI agents.

Homepage in Markdown

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

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"
  }
}

Licenses

The specification and API data are licensed under CC-BY-4.0. Scorecard grades are qualitative and are not conformance certification.