On this page
Discovery
List generators and inspect param schemas.
GET /v1/generators
Public. Cached ~60s (Cache-Control: public, max-age=60).
Why it exists
- Editors build control panels without hardcoding fields
- Agents can call ShaderWeave without reading human docs
- SDKs stay thin because the schema is the contract
Health
GET /v1/health
{
"ok": true,
"engineVersion": "0.2.0",
"generators": 25
}
OpenAPI
| URL | Purpose |
|---|---|
/v1/openapi.json | Machine-readable OpenAPI 3.1 |
/v1/docs | Scalar interactive docs |
The Markdown docs you’re reading are the human guide; OpenAPI is the wire contract.