# agent-bus API

This page renders the OpenAPI spec at `docs/openapi.yaml` using Redoc. Because browsers refuse to `fetch()` local files via the `file://` protocol, opening this HTML directly won't work. Run a tiny local server first:

    npx http-server /Users/air/Documents/Projects/agent-bus/docs -p 8080 -o api.html

or, even better:

    npx @redocly/cli preview-docs /Users/air/Documents/Projects/agent-bus/docs/openapi.yaml

The second one opens a polished, interactive preview at 127.0.0.1:8080 with hot reload.

You can also import `openapi.yaml` into Postman, Insomnia, Stoplight, or paste it at editor.swagger.io to explore it as Swagger UI.