The Illuminated Intelligence business intelligence API.

The Illuminated Intelligence API is organized around predictable, resource-oriented URLs and uses standard HTTP response codes, authentication, and verbs. All requests and responses are JSON-encoded. The base URL for all API requests is https://api.illuminatedintelligence.ai/v1.

Authentication is via Bearer tokens, scoped per workspace and per role. You can generate API keys from your workspace settings — read-only, write, and admin scopes are supported. Tokens never expire but can be rotated or revoked at any time.

The API exposes endpoints for the same resources you use in the platform UI: /integrations to manage data source connections, /datasets to query unified data, /dashboards to manage and embed dashboards, /insights to retrieve AI-generated insights from JARVIS, and /alerts to manage notification rules.

Most endpoints support standard list operations with cursor-based pagination, filtering, and sorting. Detailed parameter documentation is available in the OpenAPI spec.

Need to put an Illuminated Intelligence dashboard inside your own portal, customer-facing app, or internal tool? Use our signed-URL embedding to drop any dashboard into an iframe with row-level security applied based on the user you specify in the signing request. No data is exposed to the client beyond what the signed user is authorized to see.

Configure webhook endpoints to receive real-time push notifications when an integration syncs, an alert fires, or JARVIS detects an opportunity worth flagging. Standard HMAC SHA-256 request signing, automatic retries with exponential backoff, and a delivery dashboard make webhooks production-ready out of the box.

Official SDKs are in development for TypeScript/Node, Python, Ruby, and Go. In the meantime, the API is fully usable with any HTTP client. Get in touch if you'd like early access to a private SDK preview.