Role Groups
Create a role group.
ROLES: INSTANCE_ADMIN USER: true SERVICE ACCOUNT: true
POST
/
api
/
v1
/
role-groups
Create a role group.
curl --request POST \
--url https://api.revoengine.com/api/v1/role-groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Instance administrators"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Instance administrators'})
};
fetch('https://api.revoengine.com/api/v1/role-groups', 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"
payload = { "name": "Instance administrators" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)Authorizations
Bearer JWT token or API Key (sk-*).
Body
application/json
Display name of the role group.
Example:
"Instance administrators"
Operator-visible description of the role group.
Example:
"Users who can administer the full instance."
Optional presentation category for the role group.
Example:
"Administration"
Optional 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": "ops" }
Optional user ids to attach as role-group members during creation.
Example:
[
"33333333-3333-4333-8333-333333333333",
"44444444-4444-4444-8444-444444444444"
]
Optional role keys to assign during creation. Provide an empty array for a role group without roles.
Available options:
ASSISTANT_EVIDENCE_READ, INSTANCE_ADMIN, ME_KEY_MANAGER, ME_MODIFY_ADVANCED, ME_MODIFY_META, USER_READ, USER_WRITE, USER_ADMIN, RESOURCE_READ, RESOURCE_WRITE, RESOURCE_ADMIN, FILE_READ, FILE_ADMIN, STORAGE_ADMIN, COMPONENT_READ, COMPONENT_EXECUTE, COMPONENT_WRITE, COMPONENT_ADMIN, SECRET_READ, SECRET_WRITE, SECRET_ADMIN, AUTOMATION_READ, AUTOMATION_RUNNER, AUTOMATION_ADMIN, AGENT_USER, AGENT_READ, AGENT_RUNNER, AGENT_WRITE, AGENT_ADMIN, ENDPOINT_READ, ENDPOINT_WRITE, ENDPOINT_ADMIN, ENDPOINT_INVOKE, REALTIME_READ, REALTIME_WRITE, REALTIME_ADMIN, REALTIME_CONNECT Example:
[]
Response
Created.
Last modified on September 5, 2026
⌘I
Create a role group.
curl --request POST \
--url https://api.revoengine.com/api/v1/role-groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Instance administrators"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Instance administrators'})
};
fetch('https://api.revoengine.com/api/v1/role-groups', 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"
payload = { "name": "Instance administrators" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)