Skip to content
Himaya Himaya Himaya

API Reference

The Helios REST API is served by the FastAPI backend at https://app.himaya.ai. Interactive Swagger docs are available at /docs.

Base URL

Section titled “Base URL”
https://app.himaya.ai

Authentication

Section titled “Authentication”

Helios uses two distinct auth schemes depending on the endpoint:

Tenant / user API

Bearer JWT obtained from the login flow. Every request is scoped to the caller’s org_id.

Admin (vendor) API

Send X-Admin-API-Key: <VENDOR_ADMIN_API_KEY> to reach protected endpoints under /api/admin/*.

Example request

Section titled “Example request”
Terminal window
curl https://app.himaya.ai/api/admin/orgs \
  -H "X-Admin-API-Key: $VENDOR_ADMIN_API_KEY"

Health check

Section titled “Health check”
Terminal window
curl https://app.himaya.ai/health