Skip to main content

Overview

The Moda Data API provides read access to your conversation analytics data. Use it to programmatically query conversations, monitor user frustration, investigate tool failures, and explore topic clusters.

Access Methods

CLI

Query your analytics directly from the terminal. Search conversations, investigate frustrations, debug tool failures.

REST API

Direct HTTP access to all Data API endpoints. Authenticate with your Moda API key.

Available Data

CategoryDescription
OverviewDashboard KPIs, top clusters, recent activity
ConversationsSearch, filter, and retrieve conversation context
World StateSearch conversations by world-state/profile keywords; inspect a conversation’s slots, threads, and event log
ClustersBrowse topic cluster hierarchy
FrustrationsUser frustration detections with evidence
Tool FailuresTool failure overview and per-tool detail

Authentication

All Data API access requires a Moda API key. Get yours from Settings. The API key is passed as an x-api-key header for REST requests, or as the MODA_API_KEY environment variable for the CLI.
The Data API is read-only. To send conversation data to Moda, see the Ingestion docs.