API Reference - SomyaLabs

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.