Skip to navigation
API ReferencePermissionsPolicies

Update Policy

Updates an existing policy.

The update is a full replacement of the policy’s bindings. Any role or resource binding not included in the request body is removed. To make a partial change, fetch the current policy with GET /api/permissions/policies/{id}, modify the relevant bindings, and send the complete object back.

Authentication

AuthorizationBasic

This is the Polytomic deployment key (on-premises only)

OR
AuthorizationBearer
This is the Polytomic API key

Path parameters

idstringRequiredformat: "uuid"
Policy ID

Headers

X-Polytomic-VersionstringRequired

Request

This endpoint expects an object.
namestringRequired
policy_actionslist of objects or nullRequired
organization_idstring or nullOptionalformat: "uuid"

Ignored for user and organization-scoped API keys, which always act in their own organization

Response

OK
dataobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error