Noesis API

Noesis has its own base URL and takes the same API keys. Its live-call WebSocket, authentication and every Noesis REST endpoint, with the OpenAPI description.

Noesis tells who or what answered a phone call. It has one WebSocket for live calls and a few REST endpoints, on its own host. Every REST endpoint has its own page, generated from the OpenAPI description, with examples in cURL, Python and JavaScript.

Base URL

Noesis does not run on platform.detectif.ai like Aletheia and Eidos. Its endpoints are on:

Example
https://api.noesis.detectif.ai
wss://api.noesis.detectif.ai/v1/detect/stream

Authentication

Noesis takes the same API keys as the other products. Send the key as a bearer token; it needs the Noesis permission (noesis:detect or noesis:read):

Shell
curl https://api.noesis.detectif.ai/v1/detect/usage \
  -H "Authorization: Bearer $DETECTIF_API_KEY"

See Authentication for Noesis.

Live calls

WS /v1/detect/stream is one WebSocket per call: stream the callee's audio, receive the answers. OpenAPI does not describe WebSockets, so it has its own page: Stream protocol. Clients that cannot set the Authorization header use a stream token.

Endpoints

Base URL: https://api.noesis.detectif.ai (live stream: wss://api.noesis.detectif.ai). Same API keys as the other products; the key needs the Noesis permission.

Method Path Page
WS /v1/detect/stream Live call stream
POST /v1/detect/stream-tokens Create a stream token
POST /v1/detect/file Analyse a call recording
GET /v1/detect/sessions/{session_id} Get a call session
GET /v1/detect/sessions List call sessions
GET /v1/detect/usage Get your Noesis usage
GET /v1/health Check service health

Errors share one shape with a stable error.code; see Noesis errors.

OpenAPI and Postman