API Reference
The Wiselook public API. Every endpoint here is reached through the
gateway under /v1/{resource} and authenticated with a bearer token —
see Authentication for how to get
one.
Services
| Service | What it exposes |
|---|---|
| Identity | Canonical user accounts (public surface). |
| Tenancy | Widget bootstrap + visitor-session minting. |
| Catalog | Methodologies, competencies, ECOs, questions. |
| Assessment | Evaluations — create and read assessment runs. |
| AI Service | Claire's chat + voice surface; transcript reads. |
Conventions
- Base URL:
https://<WISELOOK_HOST>/v1/… - Auth:
Authorization: Bearer <token>on every call. - Errors: the
{code, detail, extra}shape — branch oncode. - Versioning: the version is at the path root; breaking changes ship
under
/v2/.
These reference pages are generated from each service's OpenAPI spec, so they always match the deployed contract. The request/response schemas and the "try it" console below come straight from the spec.