Skip to main content
PUT
Update a policy's identity fields

Authorizations

x-api-key
string
header
required

Path Parameters

policy_id
string<uuid>
required

Body

application/json

Patch a policy's identity fields (NOT its config — that's a new revision).

scope is intentionally NOT here: it is an identity-level fact set ONCE at create (spec §2 — moved off the revision to Policy, server_default='attachable', with no update path). Allowing it on PUT would advertise a mutable field the service silently drops; organization-vs-attachable is decided at authoring time, so it stays immutable post-create.

name
string | null
Required string length: 1 - 255
description
string | null
enabled
boolean | null
metadata
Metadata · object | null

Response

Successful Response

id
string<uuid>
required
organization_id
string<uuid>
required
name
string
required
enabled
boolean
required
scope
string
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
description
string | null
active_revision_id
string<uuid> | null
active_revision
PolicyRevisionResponse · object | null
metadata
Metadata · object