Skip to main content

API Reference

All triage-related endpoints across the platform.

Knowledge Service

GET /v1/knowledge/inbox

List triage items awaiting human review. Headers: x-tenant-id (required) Query: limit (default 50, max 100), offset Response: Items with approval_status IN ('pending', 'deferred')

PATCH /v1/knowledge/triage/:id

Human decision boundary for triage items. Headers: x-tenant-id (required), x-user-id (required) Body:
Response:

POST /v1/triage/session

Classify and stage a session for triage. Called by MCP Connector. Headers: x-tenant-id (required) Body:
Response:

GET /v1/triage/approved

List approved triage items for Memory Consolidator. Headers: x-tenant-id (required) Query: start_time, end_time, limit (default 100, max 500) Response: Items with approval_status = 'approved'

POST /v1/triage/run

Manually trigger a triage consolidation cycle. Headers: x-tenant-id (required) Body:
Response:

GET /v1/triage/status

Get triage pipeline status. Headers: x-tenant-id (required) Response:

IQ Hub (Knowledge Service)

POST /conversations/:id/archive

Archive a conversation and trigger memory extraction. Headers: x-tenant-id, x-user-id (both required) Query: extract_memories (default true) Response:

GET /sessions

List sessions for Memory Consolidator. Headers: x-tenant-id (required) Query: start_time, end_time, limit Response:

Memory Consolidator

POST /trigger/:type

Manually trigger consolidation. Path: type = hourly | daily | weekly Response:

GET /status

Get consolidator status including last run times and locks.