Skip to main content

​
Base URL

http://localhost:8000
Configure with NTRP_HOST and NTRP_PORT.

​
Authentication

All endpoints except /health require a Bearer token: 
curl http://localhost:8000/session \
  -H "Authorization: Bearer YOUR_API_KEY"
See Authentication for details.

​
Response format

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

​
Endpoints

GroupEndpointsDescription
ChatPOST /chat, POST /cancelAgent conversation with streaming
Sessions/session*, /sessions*Session management
Memory/facts*, /observations*, /dreams*Memory CRUD
Automations/automations*Scheduled tasks
Config/config*, /models*Server configuration
HealthGET /healthServer status (public)

​
Health check

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
}