API Overview

Base URL

http://localhost:8000

Configure with NTRP_HOST and NTRP_PORT.

All endpoints except /health require a Bearer token:

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

See Authentication for details.

All endpoints return JSON. Streaming endpoints (/chat) use Server-Sent Events (SSE).

Group	Endpoints	Description
Chat	`POST /chat`, `POST /cancel`	Agent conversation with streaming
Sessions	`/session`, `/sessions`	Session management
Memory	`/facts`, `/observations`, `/dreams*`	Memory CRUD
Automations	`/automations*`	Scheduled tasks
Config	`/config`, `/models`	Server configuration
Health	`GET /health`	Server status (public)

curl http://localhost:8000/health

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

Pass a Bearer token to also verify authentication:

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