engineering_analytics
engineering_analytics

Default-branch failures over a window (default -24h), grouped error-tracking style by (workflow, de-sharded failing job) with a run count and first/last seen, newest group first. branch overrides the detected default branch. PR-branch failures are deliberately excluded: at monorepo volume a flat feed is a firehose; those surface per PR. Groups degrade to workflow level (failed_job '') when the job-level source isn't synced.

get/api/projects/{project_id}/engineering_analytics/master_failures/

Request

  • Base URL: https://us.posthog.com
  • URL: https://us.posthog.com/api/projects/{project_id}/engineering_analytics/master_failures/
  • Auth: 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

branchstring

Optional exact git branch (head_branch) to scope results to, e.g. 'main'. Omit or leave blank to aggregate across all branches.

date_fromstring

Window start: relative ('-24h', '-7d') or ISO8601. Defaults to -24h.

date_tostring

Window end: relative or ISO8601. Defaults to now.

repostring

'owner/name' repository to scope to when the selected source syncs several repositories (from the sources list). Defaults to the source's first repository.

source_idstring uuid

Connected GitHub data warehouse source to read from. Defaults to the oldest connected GitHub source when the team has more than one.

Response

workflow_namestring required

GitHub Actions workflow name the failing runs belong to.

failed_jobstring required

De-sharded failing job name (matrix '(G/N)' suffix stripped): the group's failure signature together with the workflow. '' when the job-level source isn't synced and the group degrades to workflow level.

run_countinteger required

Distinct failing default-branch runs in this group within the window.

first_seenstring date-time required

When the oldest failing run in the group started.

last_seenstring date-time required

When the newest failing run in the group started.

latest_run_idinteger required

Run id of the newest failing run: the drill-down anchor.

Changes

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