Insights Reports
List Support Insights Reports
Paginated history of the account's Support Insights reports, newest first. Each row says which downloads exist (`files`).
Generate Support Insights Report
Queue a new report for a date range. Generation runs in the background, makes no AI or third-party call, and always gives the same result for the same data. Track progress with the returned `tracked_job_log_id` (Background jobs API) or poll Get Support Insights Report.
Estimate Support Insights Report
Before generating: how many tickets the range holds, how many have no category yet, and how many generations are left this hour (10 per hour per account). Dates are local dates in the account timezone; the same range rules as Generate apply.
Get Support Insights Report
One report. Once `status` is `ready` it carries the frozen evidence `pack` (every number, chart series and ranked finding), plus `scope_notes` (what the report can't tell you) and `verified_facts` (reconciliations). `pack` is null until ready. `error_public` explains a failed or blocked report.
Delete Support Insights Report
Delete a report and its files (a running report is cancelled first). Its downloads return 404 afterwards.
Re-run Support Insights Report
Generate a new report over the same range, or send `{'to': 'today'}` to keep the start date and extend to today. When nothing changed, the new report reuses the earlier files and says `unchanged_since_report_id`. Same 409/429 rules as Generate.
Cancel Support Insights Report
Cancel a queued or running report; it stops at the next stage and keeps no files. 422 when the report already finished.
Get Support Insights Evidence Pack
The report's frozen evidence pack as JSON — byte-for-byte the `pack.json` in the JSON download. Intended for your own AI tools: every number cites a field, and the field dictionary ships in the JSON download (`fields.md`). 404 until the report is ready.
Download Support Insights Report
Download a file of a ready report as an attachment: