---
title: "Update an escalation rule"
method: PATCH
path: "/orgs/{org_id}/governance/escalation-rules/{rule_id}"
tags: ["Governance"]
---

# Update an escalation rule

`PATCH /orgs/{org_id}/governance/escalation-rules/{rule_id}`

## Request

- Base URL: `https://api.mnemom.ai/v1`
- URL: `https://api.mnemom.ai/v1/orgs/{org_id}/governance/escalation-rules/{rule_id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Mnemom-Api-Key`

Authorized: org_admin or org_owner.

## Path parameters

- `org_id` string, required
- `rule_id` string, uuid, required

## Request body

- object
  - `name` string: New human-readable name for the escalation rule; omit to keep the current one.
  - `predicate` GovernanceEscalationPredicate
    - `source` 'sideband.drift' | 'sideband.coherence' | 'sideband.fault_line' | 'sideband.fleet' | 'network.threat_level.changed': Source detector for the signal. Closed enum per ADR-048 §1. `network.threat_level.changed` added in migration 234.
    - `pattern_type` string
    - `severity` 'info' | 'warn' | 'high' | 'critical'
    - `severity_min` 'info' | 'warn' | 'high' | 'critical'
    - `severity_max` 'info' | 'warn' | 'high' | 'critical'
    - `scope` 'platform' | 'org' | 'team' | 'agent': Scope at which the signal is produced and routed (ADR-048 §1).
    - `team_id` string, uuid
    - `threshold_count` integer
    - `window_minutes` integer
  - `destination_ids` string[]: Allowed empty when enabled is false (Tier 4 §4.4 default rules)
  - `enabled` boolean: Turn the rule on or off; omit to leave it unchanged.

## Response `200`

Escalation rule.

- GovernanceEscalationRule
  - `id` string, uuid, required
  - `org_id` string, required
  - `name` string, required
  - `predicate` GovernanceEscalationPredicate, required
    - `source` 'sideband.drift' | 'sideband.coherence' | 'sideband.fault_line' | 'sideband.fleet' | 'network.threat_level.changed': Source detector for the signal. Closed enum per ADR-048 §1. `network.threat_level.changed` added in migration 234.
    - `pattern_type` string
    - `severity` 'info' | 'warn' | 'high' | 'critical'
    - `severity_min` 'info' | 'warn' | 'high' | 'critical'
    - `severity_max` 'info' | 'warn' | 'high' | 'critical'
    - `scope` 'platform' | 'org' | 'team' | 'agent': Scope at which the signal is produced and routed (ADR-048 §1).
    - `team_id` string, uuid
    - `threshold_count` integer
    - `window_minutes` integer
  - `destination_ids` string[], required
  - `enabled` boolean, required
  - `last_fired_at` string, date-time, nullable
  - `fire_count` integer, required
  - `created_by` string, uuid, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `403`: Forbidden
- `404`: Resource not found
- `429`: Rate-limit exceeded. The global per-IP limiter (100 requests/minute, applied to every `/v1/*` route) rejected this request. Back off until the window resets — `Retry-After` carries the cooldown in seconds and `X-RateLimit-Reset` the absolute reset time.
- `500`: Server error — request was well-formed but the server failed to fulfill it. Typically a downstream dependency (DB / RPC / external API) returned an unexpected error.

---

[API](https://skmtc.dev/mnemom/apis/mnemom-api.md) · [All operations](https://skmtc.dev/mnemom/apis/mnemom-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mnemom/apis/mnemom-api/revisions/274b7a6ea182?raw)