DocumentationAPI v1
Organisation rollout watchdog
Inspect standing-decision drift, shadow rule promotion readiness, and routed canary health across an authenticated organisation's active workloads.
GET /api/v1/org/watchdogcurl https://vitna.ai/api/v1/org/watchdog \
-H "Authorization: Bearer vitna_key_..."Accepts either an organisation platform key (vitna_key_...) or push key (vitna_push_...). Reads aperture.* and witness.* through the read-only site role (vitna_site) and mutates nothing: every promotion, rung expansion, or rollback recommendation emits the exact `aperture:*` operator command to execute. See Rollout and decision watchdog for all workload and rule verdicts.
Query parameters
| Parameter | Meaning |
|---|---|
workload | Optional workload slug (deep-research) or qualified id (convexity/deep-research) |
window | Optional closed UTC date range (YYYY-MM-DD..YYYY-MM-DD); defaults to each workload's newest deployment_observation window |
minShadowMatches | Minimum shadow matches before promote_ready (default 50) |
minCanaryUnits | Minimum served canary units before expand_or_adopt_ready (default 100) |
maxUnservedRatePct | Maximum unserved attempt rate percentage (default 5) |
maxFallbackSharePct | Maximum fallback share of served units percentage (default 10) |
maxPriceDriftPct | Maximum unit-cost increase vs standing decision percentage (default 10) |
Response shape
{
"orgId": "convexity",
"orgName": "Convexity",
"summary": {
"workloads": 2,
"healthy": 1,
"unruled": 0,
"attention": 1,
"decisionDrifted": 0,
"rollbackRecommended": 0,
"promoteReadyRules": 0,
"expandReadyRules": 1,
"rollbackRules": 0
},
"thresholds": {
"minShadowMatches": 50,
"minCanaryUnits": 100,
"maxUnservedRatePct": 5,
"maxFallbackSharePct": 10,
"maxPriceDriftPct": 10
},
"sentence": "convexity: all standing decisions hold; 0 shadow rules are ready to promote and 1 canary is ready to advance.",
"recommendedCommands": [
"npm run aperture:rule:add -- --workload convexity/deep-research --kind traffic_share --share 25 --sku anthropic/claude-sonnet-4-6"
],
"workloads": [ ... ],
"meta": {
"generatedAt": "2026-11-05T12:00:00.000Z",
"workloadCount": 2,
"window": "latest"
}
}