Update Organization Policy | Confident AI Docs

curl -X PUT https://api.confident-ai.com/v1/organization/policies/policyId \
     -H "CONFIDENT_API_KEY: <ORGANIZATION-API-KEY>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Manage billing",
  "permissionIds": [
    "perm-uuid-1",
    "perm-uuid-2"
  ],
  "description": "Grants full access to billing settings"
}'

{
  "success": true,
  "data": {
    "policy": {
      "id": "policy-uuid-2",
      "name": "Manage billing",
      "description": "Grants full access to billing settings",
      "permissions": [
        {
          "id": "perm-uuid-1",
          "name": "billing:read"
        },
        {
          "id": "perm-uuid-2",
          "name": "billing:write"
        }
      ]
    }
  }
}

Updates a custom organization policy's name, description, or permissions.

Path parameters

policyIdstringRequired

The unique identifier of the policy.

Request

This endpoint expects an object.

namestringRequired

Name of the policy

permissionIdslist of stringsRequired

The ids of the permissions granted by this policy

descriptionstring or nullOptional

Optional description of the policy

Response

successboolean

Indicates if the request was successful

dataobject

Path parameters

Headers

Request

Response