Skip to main content

OTTO API Reference

Complete endpoint documentation for the OTTO Messenger Server v3.3. All endpoints run on customer premises.

Endpoints

POST/api/otto/ask

NLP query → structured intelligence card (JSON). Includes BrainScore, Truth Verifier, Monte Carlo simulation, recommended actions.

ParameterTypeRequiredDescription
querystring<svg className="w-4 h-4 inline-block align-text-bottom flex-shrink-0" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round"><polyline points="20 6 9 17 4 12"/></svg>Natural-language business question
tenant_idstringCustomer tenant identifier
GET/api/otto/stream

SSE stream — word-by-word answer + final intelligence card. Use with EventSource or Fetch ReadableStream.

ParameterTypeRequiredDescription
querystring<svg className="w-4 h-4 inline-block align-text-bottom flex-shrink-0" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round"><polyline points="20 6 9 17 4 12"/></svg>Natural-language question
tenant_idstringTenant ID
POST/api/otto/learn

Ingest customer business data for Fast Learning context enrichment. Persisted to SQLite.

ParameterTypeRequiredDescription
domainstring<svg className="w-4 h-4 inline-block align-text-bottom flex-shrink-0" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round"><polyline points="20 6 9 17 4 12"/></svg>Business domain (SALES, FINANCE, …)
labelstring<svg className="w-4 h-4 inline-block align-text-bottom flex-shrink-0" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round"><polyline points="20 6 9 17 4 12"/></svg>Human-readable dataset name
dataobject<svg className="w-4 h-4 inline-block align-text-bottom flex-shrink-0" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round"><polyline points="20 6 9 17 4 12"/></svg>Key-value pairs of KPIs
GET/api/otto/learn/status

Returns count and summary of all ingested learning context entries.

GET/api/otto/nlp-capabilities

Returns active NLP stack details: backend, models, accuracy, domain count, zero_knowledge flag.

GET/api/otto/cockpit-data

Full cockpit snapshot across all 17 platforms. Used by the Enterprise Intelligence Cockpit dashboard.

GET/api/otto/platform/{platform_id}

Single platform intelligence detail. platform_id is one of: sales, finance, supply, people, marketing, customer, cyber, operations, risk, controlling, innovation, sourcing, legal, strategy, communications, data, commerce.

POST/workflow/action

Execute a recommended action. Returns execution_id and QUEUED status.

ParameterTypeRequiredDescription
actionstring<svg className="w-4 h-4 inline-block align-text-bottom flex-shrink-0" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round"><polyline points="20 6 9 17 4 12"/></svg>Action text from recommended_actions
platformstring<svg className="w-4 h-4 inline-block align-text-bottom flex-shrink-0" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round"><polyline points="20 6 9 17 4 12"/></svg>Source platform
severitystringlow | medium | high | critical
GET/workflow/actions/log

Full action lifecycle log with status, timestamps, and outcome (before/after values for chart rendering).