#Stats

---

#GET /{o}/{p}/stats/entities-by-state

Entities-by-state time series

Bucketed counts of entities per state over a time window.

Auth: Bearer token required · Permission: data:read

Path parameters

Name	Type	Description
o	string
p	string

Query parameters

Name	Type	Description
window	1h | 24h | 7d	Time window — default 24h
bucket	1m | 5m | 1h | 1d	Bucket granularity — default 1h

Responses

Status	Description	Schema
200	OK	EntitiesByStateStats
401	Unauthorized	Error
403	Forbidden	Error

---

#GET /{o}/{p}/stats/runs-by-type

Action runs by type

Per-action run totals (succeeded/failed/running) plus an hourly sparkline over the window.

Auth: Bearer token required · Permission: data:read

Path parameters

Name	Type	Description
o	string
p	string

Query parameters

Name	Type	Description
window	1h | 24h | 7d	Time window — default 24h

Responses

Status	Description	Schema
200	OK	RunsByTypeStats
401	Unauthorized	Error
403	Forbidden	Error

---

#GET /{o}/{p}/stats/failing-kinds

Failing entity kinds

Entity kinds with failing action runs in the window, sorted by failure count.

Auth: Bearer token required · Permission: data:read

Path parameters

Name	Type	Description
o	string
p	string

Query parameters

Name	Type	Description
window	1h | 24h | 7d	Time window — default 24h

Responses

Status	Description	Schema
200	OK	FailingKindsStats
401	Unauthorized	Error
403	Forbidden	Error

---

#GET /{o}/{p}/stats/drift-density

Drift density heatmap

Open-drift counts grouped by entity kind and (optionally) a cell label key — the heatmap matrix.

Auth: Bearer token required · Permission: data:read

Path parameters

Name	Type	Description
o	string
p	string

Query parameters

Name	Type	Description
dim	string	Dimensions to bucket — e.g. "kind,cell"

Responses

Status	Description	Schema
200	OK	DriftDensityStats
401	Unauthorized	Error
403	Forbidden	Error

#Schemas

#DriftDensityStats

Field	Type	Description
kinds	string[]	(required)
cells	string[]	(required)
counts	integer[][]	(required)

#EntitiesByStateStats

Field	Type	Description
buckets	object[]	(required)

#Error

Field	Type	Description
error	string	(required)
code	string

#FailingKindsStats

Field	Type	Description
rows	object[]	(required)

#RunsByTypeStats

Field	Type	Description
rows	object[]	(required)