Oculis API
Oculis offers an HTTP API for reading your observability data — agents, runs, costs, and alerts — so you can pull it into a system you already run.
Programmatic access is available on Premium and Enterprise plans.
Find the API reference
Section titled “Find the API reference”The complete endpoint reference is published inside Oculis, at /docs/api. It is generated
from the running service, so it always matches the version you are actually calling.
Authenticate
Section titled “Authenticate”Requests are authenticated with an API key, created in Settings → API keys. See Credentials & access for how keys are issued, stored, and revoked.
Send the key with each request rather than embedding it in a URL, and store it as a secret in whatever runs your integration — not in source control.
What the API covers
Section titled “What the API covers”At a high level, the API exposes the same data you see in the product:
- Agents — the AI workloads Oculis has discovered, and their activity
- Runs — individual executions, with the detail behind each one
- Costs and usage — spend and token consumption, broken down the way the product breaks it down
- Alerts — the alerts configured for your organization
Consult the reference in Oculis for exact paths, parameters, and response shapes.
Versions
Section titled “Versions”This page describes the API in Oculis SaaS 1.0.0. The Collector is versioned separately — see Oculis Collector.