Skip to content

Analytics API

The public Analytics surface is Chat and Digital Brain. There is no POST /public/v1/analytics/query endpoint and no GET /public/v1/analytics/status health check.

Base URL

BASE_URL = "https://api.fermi.dev"

What to call

Goal Endpoint Docs
Organization onboarding conversation POST ${BASE_URL}/public/v1/analytics/chat with "action": "onboarding" and "step": 1 Organization Onboarding
Connect and sync sources POST ${BASE_URL}/public/v1/connect/integrations/connect-session Data Connectors
Render the knowledge graph POST ${BASE_URL}/public/v1/analytics/perform/action with "action": "visualization" Brain
Review Brain findings GET ${BASE_URL}/core-analytics/validation/findings Validation
Ask Fermi (product chat) POST ${BASE_URL}/agents-service/api/v1/agentcore/chat/stream Chat & Sessions
Update the knowledge graph in natural language POST ${BASE_URL}/public/v1/analytics/chat with "action": "graph_modification" and user_input Brain

Authentication

Authorization: Bearer <service-actor-token>

Required scopes:

  • brain:read / brain:write — visualization and graph updates
  • See Chat & Sessions for Ask Fermi

Next Steps