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
Name | Conditions |
---|---|
| Always Required |
Parameters
Path parameters
Path parameter | Description |
---|---|
| Unique identifier of the permission. Permission IDs look like this: |
Request body
In the request body specify the permisison name and/or a list of operations that this permission will allow.
propery | Required/Optional | Description |
---|---|---|
| String - Optional | Name of the permission. |
| String Array - Optional | List of allowed operations. This this list for all the available operations. |
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