> 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"
  }
}
```
