signals

Summarise recent scout output across the fleet

Return a cheap fleet-wide tally of the output the scout troop produced in the recent window — the finding count, the distinct reports authored/edited via the report channel, the number of distinct scouts behind them, and the latest output time. Backs the 'Scout findings' callout so it renders from one query instead of the client paging through the whole runs window. Counts runs that emitted at least one finding (emitted_count > 0) or authored/edited an inbox report within the last window_hours (default 72), capped to the most recent 120 such runs so the count matches what the findings list renders. Strictly team-scoped.

get/api/projects/{project_id}/signals/scout/runs/findings/summary/

Request

  • Base URL: https://us.posthog.com
  • URL: https://us.posthog.com/api/projects/{project_id}/signals/scout/runs/findings/summary/
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

project_idstring required

Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.

Query parameters

window_hoursinteger

Lookback window in hours over runs' created_at (default 72, hard cap 168).

Response

Fleet-wide tally of recent scout output — findings and report activity.

countinteger required

Total findings the fleet emitted in the window — the sum of each run's emitted_count, over the most recent 120 runs that produced output.

scout_countinteger required

Number of distinct scouts (skills) that produced output in the window — emitted a finding, or authored/edited an inbox report that survives the 50-report cap (a report-only scout whose touched reports all fell outside the cap is not counted, matching the findings page's scout filter).

authored_report_countinteger required

Number of distinct inbox reports scouts authored via emit_report, deduped across runs, over the same most-recent-120-output-runs set as count, capped to the 50 most recently touched reports (the same slice the findings page lists).

edited_report_countinteger required

Number of distinct inbox reports scouts edited via edit_report, deduped across runs, over the same most-recent-120-output-runs set as count, capped to the 50 most recently touched reports (the same slice the findings page lists) and excluding reports also authored within that set (authoring supersedes an edit; a report whose authoring run falls outside the cap counts as edited).

run_countinteger required

Number of scout runs created in the window, whether or not they produced output. Unlike the report tallies it is not capped, so it is the fleet's activity over the same span the output counts describe.

latest_atstring date-time nullable required

ISO-8601 timestamp of the most recent output run (TaskRun completion, falling back to run creation), or null when nothing was produced in the window.

Changes

No recorded changes to this operation across all 1 revision of this API.