Noesis / API Reference

Noesis API Reference

Base URL, authentication, the live-call WebSocket, and every Noesis REST endpoint with its OpenAPI description.

Noesis has one WebSocket for live calls and a few REST endpoints. Every REST endpoint has its own page, generated from the OpenAPI description, with examples in cURL, Python and JavaScript.

Base URL

Example
https://api.noesis.detectif.ai

Authentication

Send your API key as a bearer token. The key 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.

Live calls

Endpoint Description
WS /v1/detect/stream One WebSocket per call: stream the callee's audio, receive the answers. OpenAPI does not describe WebSockets; see Stream protocol.

Endpoints

Streams

Method Path Page
POST /v1/detect/stream-tokens Create a stream token

Recordings

Method Path Page
POST /v1/detect/file Analyse a call recording

Sessions

Method Path Page
GET /v1/detect/sessions/{session_id} Get a call session
GET /v1/detect/sessions List call sessions

Usage

Method Path Page
GET /v1/detect/usage Get your Noesis usage

Health

Method Path Page
GET /v1/health Check service health

OpenAPI and Postman