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

# Create an escalation rule

`POST /orgs/{org_id}/governance/escalation-rules`

## Request

- Base URL: `https://api.mnemom.ai/v1`
- URL: `https://api.mnemom.ai/v1/orgs/{org_id}/governance/escalation-rules`
- 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

## Request body

- object
  - `name` string, required: Human-readable name for the escalation rule, shown in the operator console.
  - `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: Allowed empty when enabled is false (Tier 4 §4.4 default rules)
  - `enabled` boolean: Whether the rule is active and evaluated against incoming signals (default true).

## Response `201`

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)