Public Stats
GET /api/v1/dogfood/public/stats
Unauthenticated aggregate-only tenant-zero transparency payload.
Cached by the CDN for 5 minutes via Cache-Control: public, max-age=300. Tagged noindex so search bots do not cache the
raw JSON.
The response body is a :class:PublicStatsResponse whose fields
are a frozen whitelist (DFS-04 PII safety). Any non-whitelisted
field is caught by
tests/unit/core/dogfood/test_agent_control_service.py and
test_public_stats.py long before shipping.
Authorizations
Responses
200
Successful Response
Aggregate-only tenant-zero stats for the unauthenticated
/dogfood transparency page (DFS-04).
PII-free whitelist discriminator. Every field below is numeric or
a timestamp. No email addresses, user ids, event ids, outcome ids,
actor references, or event payloads are exposed. The test suite
asserts set(PublicStatsResponse.model_fields) equals this exact
whitelist, so adding any new field is guaranteed to fail a test
before it can leak.
Attributes:
action_count_30d: Number of tenant-zero ops-log actions in the
last 30 days.
credit_spend_30d: Sum of cost_credits over the same window.
roi_ratio: Reserved for Phase 199 attribution chain. None
until the chain populates outcomes.
agent_uptime_pct: Per-role uptime percentage (0-100) computed
from the pause history in dogfood_agent_controls. The
dict is keyed by the 8 C-suite role strings.
last_autonomous_action_at: UTC timestamp of the most recent
tenant-zero ops-log action, or None if no rows exist.