# Superposition core API

**Canonical:** https://apis.io/apis/superposition/core-api/  
**Provider:** Superposition — https://apis.io/providers/superposition/  
**Base URL:** https://app.superposition.ai  
**Documentation:** https://docs.superposition.ai/docs/api

Superposition core API is one of 4 APIs that [Superposition](https://apis.io/providers/superposition/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. The published artifact set on APIs.io includes an OpenAPI specification.

Superposition core API as documented publicly: 31 operations. Contract generated from the documentation by API Evangelist (2026-10-29); not the provider's own document.

## Operations (31)

| Method | Path | Summary |
|---|---|---|
| POST | `/agent/invoke` | Run the agent |
| GET | `/agent/sessions` | List agent sessions |
| GET | `/agent/sessions/{id}` | Get a session transcript |
| GET | `/api/v1/jobs` | GET /api/v1/jobs |
| GET | `/ats/connections` | List ATS connections |
| POST | `/ats/connections` | Connect an ATS |
| DELETE | `/ats/connections/{id}` | Disconnect an ATS |
| GET | `/ats/connections/{id}` | Get an ATS connection |
| POST | `/ats/connections/{id}/extend-pause` | Extend the initial-sync pause |
| GET | `/ats/connections/{id}/runs` | Sync history |
| POST | `/ats/connections/{id}/sync` | Start a sync |
| GET | `/ats/job-links` | List ATS jobs and their mappings |
| PATCH | `/ats/job-links/{id}` | Map, unmap, set the trigger or the stage links |
| POST | `/ats/job-links/{id}/create-job` | Create a Superposition job from an ATS job |
| POST | `/ats/job-links/{id}/preview` | What mapping this job changes |
| GET | `/ats/needs-attention` | People with no usable identifier |
| POST | `/ats/needs-attention/{id}/email` | Add the missing email |
| GET | `/audit` | Read the audit log |
| GET | `/billing` | Read billing information |
| GET | `/candidates` | List candidates |
| GET | `/candidates/{id}` | Get a candidate |
| GET | `/candidates/{id}/ats` | A candidate's presence in the ATS |
| POST | `/candidates/{id}/ats-push` | Sync a candidate to the ATS |
| GET | `/jobs` | List jobs |
| GET | `/jobs/{id}` | Get a job |
| GET | `/jobs/{id}/candidates` | List a job's candidates |
| GET | `/me` | Who am I |
| GET | `/members` | List members |
| GET | `/organization` | Get organization |
| GET | `/pipeline` | Get pipeline metrics |
| GET | `/scopes` | Scope catalogue |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/superposition/openapi/_ae-authored/superposition-core-openapi-generated.yml

## Other Superposition APIs (3)

- [Superposition API](https://apis.io/apis/superposition/superposition-api/)
- [Superposition API Reference Authenticate and integrate with the Superposition API. API](https://apis.io/apis/superposition/api-api/)
- [Superposition Guides Set up your workspace, create a role, and run your first search. API](https://apis.io/apis/superposition/guides-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/superposition/core-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/superposition/.