Update Policy | Polytomic Docs

curl -X PUT https://app.polytomic.com/api/permissions/policies/248df4b7-aa70-47b8-a036-33ac447e668d \
     -H "X-Polytomic-Version: X-Polytomic-Version" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Custom",
  "policy_actions": [
    {
      "action": "read",
      "role_ids": [
        "248df4b7-aa70-47b8-a036-33ac447e668d"
      ]
    }
  ]
}'

{
  "data": {
    "id": "248df4b7-aa70-47b8-a036-33ac447e668d",
    "name": "Policy",
    "organization_id": "248df4b7-aa70-47b8-a036-33ac447e668d",
    "policy_actions": [
      {
        "action": "read",
        "role_ids": [
          "248df4b7-aa70-47b8-a036-33ac447e668d"
        ]
      }
    ],
    "system": false
  }
}

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.

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}`](../../../../api-reference/permissions/policies/get), modify the relevant bindings, and send the complete object back.

Authentication

AuthorizationBearer

Bearer user API key

AuthorizationBasic

Basic organization-scoped API key

Path parameters

idstringRequiredformat: "uuid"

Request

This endpoint expects an object.

namestringRequired

policy_actionslist of objects or nullRequired

organization_idstring or nullOptionalformat: "uuid"

Response

dataobject

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

Authentication

Path parameters

Headers

Request

Response

Errors