Reorder Firewall Policies
Bulk-rewrite the priorities of firewall policies in a single transaction. Pass an ordered list of policy IDs — the platform assigns priorities 1, 2, 3, … in that order (first ID = priority 1 = runs first). Useful when the user drags policies around in the dashboard's policy list and you want a single atomic save.
Atomic — either every priority is updated or none is. Only IDs you pass are re-prioritised, and the update is scoped to the caller's account (IDs that don't belong to the account are silently skipped). Requires the firewall_policies entitlement.
Request body
ordered_ids string[] Req
Policy UUIDs in the desired priority order (first = priority 1 = runs first). Must be non-empty.
Response (200 OK)
success boolean
true on a successful reorder.Errors
400 Bad Request
Empty
ordered_ids or invalid JSON.401 Unauthorized
Missing auth.
403 Forbidden
Plan doesn't include
firewall_policies.Request
curl -X POST "https://api.ngris.com/v1/firewall/policies/reorder" \
-H "X-API-KEY: <your_api_key>" \
-H "Content-Type: application/json" \
-d '{"ordered_ids": ["abc-123", "def-456", "ghi-789"]}'
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
client._post_raw("/firewall/policies/reorder", {
"ordered_ids": ["abc-123", "def-456", "ghi-789"],
})
Response — 200 OK
{
"success": true
}