Update a role
Log in to add to favouritesUpdate a Role
Updates an existing role.
update(role: Role): Promise<Role>
Returns
A Promise that will resolve with a Role object.
Example
let role = {
"id": "71b48d24-7f65-457d-bd51-cba977b74b74",
"name": {
"en-GB": "Movie Editors"
},
"description": {
"en-GB": "Movie editors can edit movies, but not submit or approve them"
},
"enabled": true,
"permissions": {
"entries": [
{
"id": "movie",
"languages": ["*"],
"actions": ["draft.*", "awaitingApproval.revoke"]
}
],
"contentTypes": [ ]
},
"assignments": {
"users": [ "a.user" ],
"groups": [ "Movie Editors" ],
"apiKeys": [ "Movie Import" ]
}
};
client.roles.update(role)
.then(result => {
console.log('API call result: ', result);
})
.catch(error => {
console.log('API call fetch error: ', error);
});Validations
Project does not exist
Roles are project specific. If you attempt to update a role in a project which does not exist you will get the following response.
{
"logId": "00000000-0000-0000-0000-000000000000",
"message": "There are validation errors updating the role",
"data": [
{
"field": "projectId",
"message": "The project does not exist"
}
],
"type": "Validation"
}Role does not exist
If you attempt to update a role which does not exist you will get the following response.
{
"logId": "00000000-0000-0000-0000-000000000000",
"message": "There are validation errors updating the role",
"data": [
{
"field": "projectId",
"message": "The role with id '71b48d24-7f65-457d-bd51-cba977b74b74' does not exist"
}
],
"type": "Validation"
}Insufficient permissions to update a role
In order to update a role you must be a member of the "System Administrators" user group. If you do not have permission to update a role you will get the following response.
{
"logId": "00000000-0000-0000-0000-000000000000",
"message": "There are validation errors updating the role",
"data": [
{
"message": "Access denied"
}
],
"type": "Validation"
}Content type does not exist
The content type must exist to be able to update a role. If you attempt to update a role for a content type which does not exist you will get the following response.
{
"logId": "00000000-0000-0000-0000-000000000000",
"message": "There are validation errors updating the role",
"data": [
{
"field": "entries[index].id",
"message": "The content type 'movie' does not exist"
}
],
"type": "Validation"
}Language unsupported by the content type
Language assignments for a content type id must be supported by the content type. If you attempt to update a role with a language which is not supported by the content type you will get the following response.
{
"logId": "00000000-0000-0000-0000-000000000000",
"message": "There are validation errors creating the role",
"data": [
{
"field": "Role.Permissions.Entries[index]",
"message": "The languages 'cy', 'fr' specified in the role are not supported by the content type."
}
],
"type": "Validation"
}