Update a role group. - RevoEngine

PUT

/

api

/

v1

/

role-groups

/

{roleGroupId}

Update a role group.

curl --request PUT \
  --url https://api.revoengine.com/api/v1/role-groups/{roleGroupId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "version": 7
}'

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({version: 7})
};

fetch('https://api.revoengine.com/api/v1/role-groups/{roleGroupId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.revoengine.com/api/v1/role-groups/{roleGroupId}"

payload = { "version": 7 }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

Authorizations

Authorization

string

header

required

Bearer JWT token or API Key (sk-*).

Path Parameters

roleGroupId

string

required

Body

application/json

version

number

required

Optimistic locking version for the role-group row.

Example:

7

name

string

Updated role-group display name.

Example:

"Read-only auditors"

desc

string

Updated operator-visible description.

Example:

"Users who can inspect configuration without modifying it."

category

string

Updated presentation category.

Example:

"Compliance"

metadata

object | null

Replacement resource metadata. Values may use any JSON type. Maximum 16 KiB and 64 top-level keys. Top-level keys starting with "__" are reserved for backend use.

Example:

{ "costCenter": "platform" }

Response

Created.

Last modified on September 5, 2026

Update a role group.

curl --request PUT \
  --url https://api.revoengine.com/api/v1/role-groups/{roleGroupId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "version": 7
}'

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({version: 7})
};

fetch('https://api.revoengine.com/api/v1/role-groups/{roleGroupId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.revoengine.com/api/v1/role-groups/{roleGroupId}"

payload = { "version": 7 }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)