Your chatbot now reads OpenAPI specs directly

Choosing OpenAPI as a source when creating a Biel.ai project

API questions are the ones users get stuck on most, and they are the hardest to answer from prose. Your chatbot now reads OpenAPI specs directly, so every endpoint, parameter, and schema is indexed automatically.

There is no need to crawl your rendered API reference. The chatbot reads the spec itself, which is the same source your docs are generated from.

A few ways this plays out:

Someone asks which parameters an endpoint takes and gets the exact names, types, and which are required
A user asks for the shape of a response and gets the schema, not a paraphrase of it
A question about auth gets answered from the security scheme defined in the spec

Because the spec is the source of truth, answers stay correct when you ship a new version of the API.

To turn it on, add an OpenAPI source in Settings > Sources and give it the URL or file of your spec. The OpenAPI docs walk through both.

One tip: keep your descriptions in the spec itself. The summary and description fields on each operation are what the chatbot uses to explain an endpoint in plain language, so a spec with good descriptions answers far better than a bare one.

Want help wiring up your spec? Hit reply and we'll get you set up.