API Reference
Log In
API Reference

Get insights run

Fetch a single AI insights run by ID, scoped to the authenticated team.

The dashboard_url field is a direct link to the Insights page in the Revenium UI for this run.

Full mode (default, slim=false): Returns all fields including findingsJson, recommendationsJson, and batchMetadataJson (raw JSON strings requiring JSON.parse), plus pre-parsed equivalents parsedFindings, parsedRecommendations, and parsedBatchMetadata for MCP consumers. Use findingsCount and recommendationsCount for quick metadata checks without parsing.

Slim mode (slim=true): Omits findingsJson, recommendationsJson, parsedFindings, and parsedRecommendations. Instead returns recommendationsSummary: [{ id, title, rank, severity, monthlyImpact, confidenceBand, category }] — a compact ranked list safe to inline in MCP tool responses without exceeding context budgets. batchMetadataJson and parsedBatchMetadata are still included. Use findingsTruncated and findingsConsideredCount to detect whether findings were capped before synthesis.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Query Params
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
API Key
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json