Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ntrp.io/llms.txt

Use this file to discover all available pages before exploring further.

Get current session

curl http://localhost:6877/session \
  -H "Authorization: Bearer $API_KEY"
{
  "session_id": "abc-123",
  "name": "Work planning",
  "sources": ["memory", "gmail", "calendar"]
}

Get session history

Returns full message history including tool call and tool result messages, allowing clients to reconstruct the conversation with tool visualizations.
curl http://localhost:6877/session/history?session_id=abc-123 \
  -H "Authorization: Bearer $API_KEY"

Create session

curl -X POST http://localhost:6877/sessions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Project review"}'

List sessions

curl http://localhost:6877/sessions \
  -H "Authorization: Bearer $API_KEY"
Returns up to 20 most recent sessions.

Rename session

curl -X PATCH http://localhost:6877/sessions/abc-123 \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "New name"}'

Archive session

curl -X DELETE http://localhost:6877/sessions/abc-123 \
  -H "Authorization: Bearer $API_KEY"
Archived sessions can be restored.

Restore archived session

curl -X POST http://localhost:6877/sessions/abc-123/restore \
  -H "Authorization: Bearer $API_KEY"

Permanently delete

curl -X DELETE http://localhost:6877/sessions/abc-123/permanent \
  -H "Authorization: Bearer $API_KEY"

Clear session history

curl -X POST http://localhost:6877/session/clear \
  -H "Authorization: Bearer $API_KEY"

List archived sessions

curl http://localhost:6877/sessions/archived \
  -H "Authorization: Bearer $API_KEY"