> Source: https://vitna.ai/docs/api/v1/engine/org-watchdog
> Raw Markdown: https://vitna.ai/docs/api/v1/engine/org-watchdog.md
> Corpus index: https://vitna.ai/llms.txt
# 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/watchdog
```
```bash
curl 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:*`](../../../cli/aperture/watchdog.md)
operator command to execute. See
[Rollout and decision watchdog](../../../routing/watchdog.md) 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
```json
{
"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"
}
}
```