The Lightsage public API exposes the same contract used by the CLI. Use it to manage Visibility prompts, start eval runs, and work with API Performance resources from your own services and automation.
The public API uses API key authentication. It does not require browser login.
Base URL
All requests use this production base URL:
Use https://api.lightsage.com for API calls.
Authenticate
Create an API key in the Lightsage dashboard:
- Open Settings > API Keys.
- Click Create API key.
- Copy the key when it is shown.
Send the key on every authenticated request with the X-Lightsage-Api-Key header:
You can also store the key with the CLI and reuse the same credential for local testing:
Check API health
Verify that the public API is reachable:
Check that your API key is valid:
Explore endpoints
The sidebar groups endpoints by resource:
- Status — health and authentication checks
- Prompts — Visibility prompt and topic workflows
- API Performance — eval runs, sources, targets, skills, and related resources
Use the interactive playground on each endpoint page to send requests with your API key.
CLI and SDK
The CLI is generated from this same OpenAPI contract. If you prefer command-line workflows, start with the CLI Reference.
Download the raw OpenAPI spec from this docs site:
For generated SDKs, see the Lightsage OpenAPI repository. 
