Policy

Atomically update the unified Global policy authority

Changed on

EDGE-052 — atomically writes one or more sections of the Global policy. Sections not present in the request body are left unchanged. A snapshot_version field on the request acts as optimistic concurrency: when non-empty and != the current snapshot the request is rejected with 409 Conflict.

put/api/v1/policy/global

Request

  • Base URL: http://localhost:8081
  • URL: http://localhost:8081/api/v1/policy/global
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Headers

X-Tenant-IDstring required

Tenant isolation header (required on all protected routes).

Request body

snapshot_versionstring

Optimistic concurrency token. When non-empty and != current snapshot, request is rejected with 409.

authorstring
messagestring
sectionsobject required

Keyed by section name. Only listed sections are written; absent sections remain unchanged.

Response

Unified Global policy updated

snapshot_versionstring
snapshot_hashstring
updated_atstring date-time
sectionsobject

Keyed by section name — input_rules, output_rules, edge_action_rules, mcp_tool_rules, invariants.

Changes

    • info

      added the media type application/json for the response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      endpoint added