Skip to main content

TrueCoverage

Short answer

Programmatic TrueCoverage mirrors the analytics UI: resolve environments, then query event lists, details, child transitions, and time series. Prefer list_rum_environments before building scopes.

Common scenarios

Discover environments

listRumEnvironments — empty body {}.

Compare coverage scopes

truecoverageListEvents uses baseExecutionScope and optional comparisonExecutionScope (environment + time window required). Set automationEmitsOnly on comparison/coverage scopes when aligning to CI emits.

Drill into an event

NeedOperation
DetailstruecoverageEventDetails
Next-event treetruecoverageListChildEventTree (baseScope / coverageScope)
Transition detailtruecoverageDetailedEventTransition
Time seriestruecoverageEventTimeSeries
Metadata keystruecoverageSessionMetadataKeys, truecoverageEventMetadataKeys

Example curl

curl -sS -X POST "$TESTCHIMP_BACKEND_URL/api/mcp/truecoverage_list_events" \
-H "Content-Type: application/json" \
-H "TestChimp-Api-Key: $TESTCHIMP_API_KEY" \
-d '{
"baseExecutionScope": {
"environment": "staging",
"timeWindow": { "relativeWindow": "P7D" }
}
}'

Frequently asked questions

Where do I start with TrueCoverage APIs?

Call list_rum_environments first, then truecoverage_list_events with baseExecutionScope (environment + time window).