Update Role

Rename a role, change its description, or set its permissions.

PUT

Path

Path parameters

stringrequired

The role's id, from List Roles.

Body

Arguments

string

A new name, up to 255 characters.

string

A new description, up to 255 characters.

array of string

The full new set of permission keys. Replaces the current set.

Try this request

API Key

Request

curl --request PUT \
  --url 'https://connect.mindcloud.co/v2/roles/:roleId' \
  --header 'Authorization: Bearer $MINDCLOUD_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{}'

{
  "success": true,
  "data": {
    "id": "string",
    "name": "Ava Chen",
    "description": "string",
    "isAdmin": true,
    "isGlobal": true,
    "createdOn": "2026-05-07T12:00:00.000Z",
    "permissions": [
      {}
    ]
  }
}