API Reference
Superposition's public and authenticated APIs.
Superposition has two APIs, and which one you want depends on whether you are reading your own data or publishing someone else's.
Authenticated API
https://app.superposition.ai/api/v1Your organization's jobs, candidates, pipeline, and agent — reached with an API key. Use this to build internal tooling, sync to a warehouse, or drive the agent from your own systems.
curl https://app.superposition.ai/api/v1/jobs \
-H "Authorization: Bearer $SUPERPOSITION_API_KEY"Authentication
Create a key, send it, and revoke it when it leaks.
Scopes
Every permission a key can hold.
Errors
The error envelope and what each code means.
Rate limits
Ceilings and safe retries.
Pagination
Paging through list endpoints.
Endpoints
| Endpoint | Scope |
|---|---|
GET /me | none beyond a valid key |
GET /scopes | none beyond a valid key |
GET /organization | organization:read |
GET /members | members:read |
GET /jobs, GET /jobs/{id} | jobs:read |
GET /jobs/{id}/candidates | candidates:read |
GET /candidates, GET /candidates/{id} | candidates:read |
GET /pipeline?jobId= | pipeline:read |
GET /agent/sessions | agents:read |
GET /agent/sessions/{id} | agents:history |
POST /agent/invoke | agents:invoke |
GET /billing | billing:read (admin) |
GET /audit | audit:read (admin) |
Public API
https://app.superposition.ai/api/public/v1The public API needs no authentication and is CORS-enabled
(Access-Control-Allow-Origin: *), so you can call it from a browser. It covers things you have
chosen to publish — job descriptions for your own careers page, and public booking.
List jobs
Fetch a company's public job descriptions.
Get availability
Open interview slots for a public booking page.
Create booking
Book a slot from a public page.
Do not send an API key to /api/public/v1. It is not needed, and a browser-side call would expose
it to anyone reading the page source.
Last updated on