Handbook

Builders — API overview

Forge Lenses exposes a single local HTTP surface from python3 -m lenses. Studio and Classic browsers call the same /api/... routes documented for operators in the maintainer handbook and summarized here for builders and…

Updated

What it is

Forge Lenses exposes a single local HTTP surface from python3 -m lenses. Studio and Classic browsers call the same /api/... routes documented for operators in the maintainer handbook and summarized here for builders and integrators.

What it is

  Root / intake
      +-- branch A
      +-- branch B
      +-- branch C
Builders reason about POST boundaries the same surfaces Studio trusts locally
Topic Page
Error envelopes, safe curl Schemas and API (builders)
Prefix families and counts Builders — route families
Generated flat + per-family tables Generated HTTP routes
Auth and secrets Builders — auth and safety
JSON schemas Builders — schemas
Versioning / stability Builders — stability policy

OpenAPI rollup (partial)

generator/export_openapi.py emits docs/generated/openapi.json whenever scripts/check-docs.sh runs. Pair it with docs/generated/api-routes.json and Schemas and API (builders) — nuanced envelopes remain code-first until a fuller export exists.

Verify

Pick one GET path from Generated HTTP routes and confirm it returns on your loopback server with the same method shown in the table.

What to do next