Update Rules Traffic

Update Policy Rule

PUT /v1/endpoints/{uuid}/policies/{policy_id}/rules/{rule_id}

Edit a rule's fields. Updates require the whole-feature traffic_policies entitlement (403 without it) but do not re-check the per-rule-type plan gating — admins on a downgraded plan can keep editing rules of types they no longer have access to (but can't add new ones via create).

Every field is optional and applied only when present (a partial patch): name, expression, config, priority, enabled, and also phase and rule_type — both are mutable on update (when you send them they replace the stored value). The resulting config is re-validated against the (possibly new) rule type's schema and re-run through the AI safety check before persistence.

Path parameters

uuid string (uuid) Req

Endpoint UUID.

policy_id, rule_id int64 Req

Policy and rule IDs.

Request body

Same fields as create — all optional. Any of name, expression, config, priority, enabled, phase, rule_type that you send is applied; omitted fields keep their stored value. Strict decoding rejects unknown fields.

Response (200 OK)

The updated rule.

Errors

400 Bad Request

Schema-invalid config, AI safety check failed, or invalid JSON.

401 Unauthorized

Missing auth.

403 Forbidden

Plan doesn't include traffic_policies.

404 Not Found

Endpoint, policy, or rule doesn't exist.

Request — bump rate limit
curl -X PUT "https://api.ngris.com/v1/endpoints/<uuid>/policies/1/rules/7" \
  -H "X-API-KEY: <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "200rps-per-ip",
    "config": {"limit": 200, "window": 1, "scope": "ip"},
    "priority": 0,
    "enabled": true
  }'

Python
from ngris import Ngris

client = Ngris(api_key="<your_api_key>")
client.traffic_policies.update_rule(
    "<endpoint_uuid>", "1", "7",
    {
        "name": "200rps-per-ip",
        "config": {"limit": 200, "window": 1, "scope": "ip"},
        "enabled": True,
    },
)

Response — 200 OK
{
  "id": 7,
  "policy_id": 1,
  "phase": "on_http_request",
  "rule_type": "rate-limit",
  "name": "200rps-per-ip",
  "config": {"limit": 200, "window": 1, "scope": "ip"},
  "priority": 0,
  "enabled": true,
  "created_at": "2026-04-29T13:00:00Z",
  "updated_at": "2026-04-29T13:10:00Z"
}

PreviousAdd Rule NextDelete Rule

On this page

Update Policy Rule