Skip to main content
The endpoint pages under API Reference are generated automatically from the backend’s OpenAPI specification — so they always match what the API actually does.

​
How it’s wired

docs.json points the Endpoints group at the backend’s live spec: 
{ "group": "Endpoints", "openapi": "https://api.somya.ai/openapi.json" }
The backend is FastAPI, which serves an always-current OpenAPI document at /openapi.json. Because we read it live, there’s no file to maintain — when the API changes, the reference updates on the next docs build.
Prefer a versioned, in-repo copy instead? Export it and point openapi at the committed file:
curl https://api.somya.ai/openapi.json -o docs-site/api-reference/openapi.json

​
Authentication

All endpoints accept your API key in either the X-API-Key header or Authorization: Bearer …. See Authentication.