Update Permission
PUT /permissions/{permissionId}
Updates an existing permission. Response either returns the updated permission (success) or the reason why it was not possible to update (failure).
User action signature required. See User Action Signing for more information.
Request headers required. See Request Headers for more information.
Authentication required. See Authentication Headers for more information.
Required Permissions
Permissions:Update
Always Required
Parameters
Path parameters
permissionId
Unique identifier of the permission. Permission IDs look like this: pm-orange-apple-2b17a80613
Request body
In the request body specify the permisison name and/or a list of operations that this permission will allow.
name
String - Optional
Name of the permission.
operations
String Array - Optional
Request example
Response
Response example 200 - no approval required
If successful, a response object of the updated permission will be returned:
Response example 202 - approval required
Notes
A permission name cannot be an empty string and a permission must have at least one operation specified.
A permission name is the unique identifier of a permission created in your organization. Therefore, multiple permissions with the same name cannot exist. If a permission has been archived, its name is still considered as taken.
Last updated