signals

List recent emitted findings across all runs

Return the team's recently emitted scout findings across every run, newest first — the cross-run counterpart to the per-run emissions action. Each row carries its run_id, so you can regroup by run without first listing runs and fanning out one emissions call each. Pass skill_name to scope to a single scout, and date_from / date_to (a half-open window on emitted_at) to bound or paginate — set date_to to the oldest emission's emitted_at to walk back past the limit. Pure Postgres, no ClickHouse round-trip. Capped at 200 rows (default 50).

get/api/projects/{project_id}/signals/scout/runs/emissions/recent/

Request

  • Base URL: https://us.posthog.com
  • URL: https://us.posthog.com/api/projects/{project_id}/signals/scout/runs/emissions/recent/
  • 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

date_fromstring date-time

ISO-8601 inclusive lower bound on emitted_at. Omit to skip the lower bound.

date_tostring date-time

ISO-8601 exclusive upper bound on emitted_at. Pass to walk back past the result cap on subsequent calls (cursor-style: set to the emitted_at of the oldest emission from the prior page).

limitinteger

Max rows to return (default 50, hard cap 200).

skill_namestring

Exact-match filter on the emitting scout's skill (e.g. signals-scout-errors). Narrows to findings one specialist surfaced; omit to span every scout on the team.

Response

Recent emitted findings across every run on the team, newest first.

idstring uuid required
run_idstring required

UUID of the SignalScoutRun that emitted this finding.

finding_idstring required

Stable id the finding was emitted under; matches an entry in the run's emitted_finding_ids.

descriptionstring required

The emitted finding prose — the signal's description as surfaced to the inbox.

tagsstring[] required

Slug tags the scout attached to this finding (lowercase kebab-case, e.g. cost-spike). Empty list when the run set none.

source_idstring required

Deterministic run:<run_id>:finding:<finding_id> — the join key into the underlying signal store.

emitted_atstring date-time required

ISO-8601 timestamp the finding was emitted.

Changes

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