Replace an agent's KPI alert thresholds
Replace the full KPI alert-rule set on an agent (max 20 rules; body rules). Persists into the agent’s existing config via a surgical jsonb_set on the operational_kpi_alert_rules key, so a concurrent edit to another config key is never clobbered. Mutating — requires the agents:write scope and an owner, admin, or developer role. Returns the stored rule set on success and 404 when the agent id is unknown to the caller’s organization.
Authorizations
Dashboard JWT token from Clerk
Headers
Stripe-style idempotency token. Pass a stable, client-generated value (1-255 chars) to dedupe retries on transient timeouts. The same key+credential+path replays the original response for 24h on 2xx (5min on 4xx, 30s on 5xx). Returns 409 if a concurrent request with the same key is already in flight; replayed responses include the Idempotency-Replay: true response header.
1 - 255Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.
true, false Path Parameters
Response
Successful response.