API Overview

Base URL

http://localhost:6877

Configure with NTRP_HOST and NTRP_PORT.

All endpoints except /health require a Bearer token:

curl http://localhost:6877/session \
  -H "Authorization: Bearer YOUR_API_KEY"

See Authentication for details.

All endpoints return JSON. The event stream (GET /chat/events/{session_id}) uses Server-Sent Events (SSE).

Group	Endpoints	Description
Chat	`GET /chat/events/{session_id}`, `POST /chat/message`, `POST /chat/background`, `POST /cancel`	SSE stream, messaging, background mode
Sessions	`/session`, `/sessions`	Session management
Memory	`/admin/memory/*`	Memory records, lenses, search, and graph inspection
Automations	`/automations`, `/notifiers`	Scheduled tasks, notifier configs
Config	`/config`, `/models`, `/providers`, `/services`, `/directives`	Configuration, providers, models
Health	`GET /health`	Server status (public)

curl http://localhost:6877/health

{
  "status": "ok",
  "version": "0.15.0"
}

Pass a Bearer token to also verify authentication:

{
  "status": "ok",
  "version": "0.15.0",
  "auth": true
}