Get started

Organisation rollout watchdog

Source

Inspect standing-decision drift, shadow rule promotion readiness, and routed canary health across an authenticated organisation's active workloads.

text
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:*` operator command to execute. See Rollout and decision watchdog for all workload and rule verdicts.

Query parameters

ParameterMeaning
workloadOptional workload slug (deep-research) or qualified id (convexity/deep-research)
windowOptional closed UTC date range (YYYY-MM-DD..YYYY-MM-DD); defaults to each workload's newest deployment_observation window
minShadowMatchesMinimum shadow matches before promote_ready (default 50)
minCanaryUnitsMinimum served canary units before expand_or_adopt_ready (default 100)
maxUnservedRatePctMaximum unserved attempt rate percentage (default 5)
maxFallbackSharePctMaximum fallback share of served units percentage (default 10)
maxPriceDriftPctMaximum 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"
  }
}