> ## Documentation Index
> Fetch the complete documentation index at: https://www.plain.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# threadHeatmapMetric

> Fetch a heatmap metric for threads with filter support, distributing thread activity across a
7-day × 24-hour grid. Unlike the legacy `heatmapMetric`, this query uses the unified
`ThreadMetricFilters` input for consistent filtering by label, tier, assignee, and more.
Requires `metrics:read`; filtering `assignedToUser` to anyone other than the caller
additionally requires `metricsAgent:read`.