Skip to main content


The updateRole function allows you to modify the name of a role in the network's Role-Based Access Control (RBAC) system. This function returns a JSON object with a role ID and a new name.


  • roleId (type: string, required): ID of the role you want to update.

  • name (type: string, required): a new name you want to assign to the role.

  • address (type: address, optional): address of the entity initiating the update.

  • seed (type: string, optional): seed used for transaction signing.

Code example

* Updates a role's name in the peaq network's RBAC system.
* @param {string} roleId - The ID of the role to be updated.
* @param {string} name - The new name for the role.
* @param {string} [address] - The address of the entity initiating the request (optional).
* @param {string} [seed] - The seed for transaction signing (optional).
* @returns {Promise<object>} - A promise that resolves when the role is successfully updated.
const updateRole = async (roleId, name, seed) => {
// Connect to the peaq network's RBAC system using the provided parameters
const sdkInstance = await Sdk.createInstance({
baseUrl: "wss://",

try {
// Update the role's name with the provided new name
const result = await sdkInstance.rbac.updateRole({
return result
} finally {
// Disconnect from the network after the operation
await sdkInstance.disconnect();

const seed = "your-seed-phrase";
const roleId = "78709009-cf06-4224-8632-b5ee8512";
const updatedName = "newRoleName";

updateRole(roleId, updatedName, seed)
.then((result) => {
.catch((error) => {
console.log("Error", error);

Response object

message: "Successfully update role 78709009-cf06-4224-8632-b5ee8512 with new name: newRoleName"