Update permission details
Modifies an existing permission's attributes including description and metadata. Use this endpoint to update permission descriptions or clarify permission purposes after creation. The permission is identified by its unique name in the path parameter, and only the fields you specify in the request body will be updated. Note that the permission name itself cannot be changed as it serves as the immutable identifier. This operation is useful for maintaining clear documentation of permission purposes or updating descriptions to reflect changes in system functionality. Returns the updated permission object with modified timestamps.
Path parameters
Name of the permission
Request body
Example request
{
"description": "Allows user to read documents from the system",
"name": "read:documents"
}Response
Permission updated successfully. Returns the modified permission object with updated description and timestamps.
Example response
{
"permission": {
"is_scalekit_permission": true
}
}