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"

Headers

X-Polytomic-VersionstringRequired

Request

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

Response

OK
dataobjectOptional

Errors

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