REST API reference

REST API reference

All Certorix data is available via REST API. Authenticated endpoints require a Bearer token in the Authorization header.

Authentication

Authorization: Bearer YOUR_ACCESS_TOKEN
X-Organization-Id: YOUR_ORG_ID

Diagnostic Trees endpoints

• GET /api/trees – List all trees (paginated, sortable)
• POST /api/trees – Create a new tree
• GET /api/trees/:treeId – Get a single tree
• PUT /api/trees/:treeId – Update tree metadata or nodes
• DELETE /api/trees/:treeId – Soft-delete a tree
• POST /api/trees/:treeId/publish – Publish tree

Facts endpoints

• GET /api/facts – List facts (search, filter, paginate)
• POST /api/facts – Create a new fact
• GET /api/facts/stats – Overview stats
• POST /api/facts/:factId/publish – Certify fact with VNT
• POST /api/facts/:factId/summarize – Queue AI summarization

Public endpoints (no auth)

• POST /public/diagnostic/start – Start a diagnostic session
• POST /public/ai-chat – Send message to AI assistant
• GET /public/orgs/:slug/llms.txt – Get AI discovery document
• GET /view/:treeId – Public diagnostic viewer
• GET /chat/:orgId – Public AI chat page