# Update role by ID Endpoint: PUT /roles/{roleId} Version: 5.1.47 Security: api_key ## Path parameters: - `roleId` (integer, required) The ID of the role to update ## Request fields (application/json): - `roleName` (string, required) The name for this Role. Note that it must be unique. Example: "NewRole" - `environment` (object) Example: {"copy":true,"delete":true,"view":true} - `environment.copy` (boolean) This field indicates whether or not this privilege has the ability to copy the object it is applied to. Example: true - `environment.create` (boolean) This field indicates whether or not this privilege has the ability to create the object it is applied to. - `environment.delete` (boolean) This field indicates whether or not this privilege has the ability to delete the object it is applied to. Example: true - `environment.export` (boolean) This field indicates whether or not this privilege has the ability to export the object it is applied to. - `environment.import` (boolean) This field indicates whether or not this privilege has the ability to import the object it is applied to. - `environment.run` (boolean) This field indicates whether or not this privilege has the ability to run the object it is applied to. - `environment.update` (boolean) This field indicates whether or not this privilege has the ability to update the object it is applied to. - `environment.view` (boolean) This field indicates whether or not this privilege has the ability to view the object it is applied to. Example: true - `connector` (object) Example: {"copy":true,"delete":true,"view":true} - `ruleset` (object) Example: {"copy":true,"delete":true,"view":true} - `inventory` (object) Example: {"copy":true,"delete":true,"view":true} - `profileJob` (object) Example: {"copy":true,"delete":true,"view":true} - `maskingJob` (object) Example: {"copy":true,"delete":true,"view":true} - `tokenizeJob` (object) Example: {"copy":true,"delete":true,"view":true} - `reidentifyJob` (object) Example: {"copy":true,"delete":true,"view":true} - `domain` (object) Example: {"copy":true,"delete":true,"view":true} - `algorithm` (object) Example: {"copy":true,"delete":true,"view":true} - `jdbcDriver` (object) Example: {"copy":true,"delete":true,"view":true} - `passwordVault` (object) Example: {"copy":true,"delete":true,"view":true} - `plugin` (object) Example: {"copy":true,"delete":true,"view":true} - `classifier` (object) Example: {"copy":true,"delete":true,"view":true} - `profileSet` (object) Example: {"copy":true,"delete":true,"view":true} - `fileFormat` (object) Example: {"copy":true,"delete":true,"view":true} - `user` (object) Example: {"copy":true,"delete":true,"view":true} - `diagnostic` (object) Example: {"copy":true,"delete":true,"view":true} - `inventoryReport` (object) Example: {"copy":true,"delete":true,"view":true} - `approveInventories` (object) Example: {"copy":true,"delete":true,"view":true} ## Response 200 fields (application/json): - `roleId` (integer) The ID of the Role. This field will be generated by the Masking Engine. - `roleName` (string, required) The name for this Role. Note that it must be unique. Example: "NewRole" - `roleType` (string) The type for this Role. All built-in roles will have type as 'DEFAULT' while roles created by user will have type as 'CUSTOM'. Enum: "CUSTOM", "DEFAULT" - `environment` (object) Example: {"copy":true,"delete":true,"view":true} - `environment.copy` (boolean) This field indicates whether or not this privilege has the ability to copy the object it is applied to. Example: true - `environment.create` (boolean) This field indicates whether or not this privilege has the ability to create the object it is applied to. - `environment.delete` (boolean) This field indicates whether or not this privilege has the ability to delete the object it is applied to. Example: true - `environment.export` (boolean) This field indicates whether or not this privilege has the ability to export the object it is applied to. - `environment.import` (boolean) This field indicates whether or not this privilege has the ability to import the object it is applied to. - `environment.run` (boolean) This field indicates whether or not this privilege has the ability to run the object it is applied to. - `environment.update` (boolean) This field indicates whether or not this privilege has the ability to update the object it is applied to. - `environment.view` (boolean) This field indicates whether or not this privilege has the ability to view the object it is applied to. Example: true - `connector` (object) Example: {"copy":true,"delete":true,"view":true} - `ruleset` (object) Example: {"copy":true,"delete":true,"view":true} - `inventory` (object) Example: {"copy":true,"delete":true,"view":true} - `profileJob` (object) Example: {"copy":true,"delete":true,"view":true} - `maskingJob` (object) Example: {"copy":true,"delete":true,"view":true} - `tokenizeJob` (object) Example: {"copy":true,"delete":true,"view":true} - `reidentifyJob` (object) Example: {"copy":true,"delete":true,"view":true} - `domain` (object) Example: {"copy":true,"delete":true,"view":true} - `algorithm` (object) Example: {"copy":true,"delete":true,"view":true} - `jdbcDriver` (object) Example: {"copy":true,"delete":true,"view":true} - `passwordVault` (object) Example: {"copy":true,"delete":true,"view":true} - `plugin` (object) Example: {"copy":true,"delete":true,"view":true} - `classifier` (object) Example: {"copy":true,"delete":true,"view":true} - `profileSet` (object) Example: {"copy":true,"delete":true,"view":true} - `fileFormat` (object) Example: {"copy":true,"delete":true,"view":true} - `user` (object) Example: {"copy":true,"delete":true,"view":true} - `diagnostic` (object) Example: {"copy":true,"delete":true,"view":true} - `inventoryReport` (object) Example: {"copy":true,"delete":true,"view":true} - `approveInventories` (object) Example: {"copy":true,"delete":true,"view":true} ## Response 400 fields ## Response 401 fields ## Response 404 fields ## Response 409 fields