# Certorix — AI-powered support certification platform

> Use this API to search diagnostic trees, run sessions, certify facts, and create tickets.
> No authentication required for all `/public/*` endpoints.

API: https://api.certorix.online/api/openapi.yaml
Docs: https://certorix.online/help
Full reference: https://certorix.online/llms-full.txt
Registry: https://api.certorix.online/api/registry/manifest

## Quick start — no API key required, no headers required

POST /public/diagnostic/start       { organizationId, treeId }
POST /public/diagnostic/next        { sessionId, organizationId, answer: { nodeId, optionId } }
POST /public/tickets/create         { organizationId, userInfo: { name, email }, formFields: { subject?, description? } }
GET  /public/search?q=query&organizationId=xxx
GET  /public/facts?organizationId=xxx&q=keyword

## How to open a support ticket (step by step)

1. Find the organization:
   GET https://api.certorix.online/public/orgs/search?q=COMPANY_NAME
   → returns [{ organizationId, slug, name, ... }]

2. Collect user name + email (ask the user if not known)

3. Create the ticket (no auth headers needed):
   POST https://api.certorix.online/public/tickets/create
   Content-Type: application/json
   Body: {
     "organizationId": "<from step 1>",
     "userInfo": { "name": "User Name", "email": "user@example.com" },
     "formFields": { "subject": "Issue title", "description": "Details..." }
   }
   → returns { ticketId, ticketUrl }

## Discovery

GET /public/orgs/search?q=COMPANY      — find an organization + get organizationId
GET /public/orgs/{slug}/trees          — list published diagnostic trees
GET /public/orgs/{slug}/facts          — list verified facts (VNT-signed)
GET /ai-agents.json                    — full machine-readable platform index

## Verify a fact

GET  /public/vnt/{vntId}
POST /public/vnt/verify  { vntId }

## MCP Integration (Claude.ai, Cursor, VS Code)

Add this to Claude.ai → Settings → Integrations → Add Integration:
  URL:  https://api.certorix.online/mcp
  Auth: Bearer <api_token>   (generate at certorix.online → Settings → API & MCP)

Available MCP tools: list_trees · get_tree · create_tree · update_tree · publish_tree
                     list_facts · create_fact · list_kb_articles · get_helpdesk_status

## About

- Platform: https://certorix.online
- Node types: question, input, info, condition, solution, jump
- Crypto: Ed25519 VNT proofs · SHA-256 content hashes
- AI: Llama 3.3 70B (trees + chat) · Llama 3.2 90B (fact verification)
- Integrations: Freshdesk · Zendesk · Zoho Desk · WordPress

© 2026 Certorix. AGPL-3.0.