List group roles
/api/group/rolesThe group's roles, read from VRChat when you ask, in VRChat's order. Each role's permissions are VRChat's own ids (group-bans-manage; * is every permission). heldByModbot says whether Modbot's VRChat account has the role, as last read. One request to VRChat per call, never retried.
Needs the ManageGroupRoles permission.
An API key, made on Settings, API keys. Every key starts with mbk_.
In: header
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/api/group/roles"{ "roles": [ { "id": "string", "name": null, "description": null, "permissions": [ "string" ], "order": 0, "isDefault": true, "isManagementRole": true, "isSelfAssignable": true, "requiresTwoFactor": true, "heldByModbot": true } ], "readAt": "2019-08-24T14:15:22Z"}Update group post PUT
Change the post named in the address: the title, text, `visibility` and `roleIds` replace what it had. VRChat replaces the whole post, so send `imageId` back to keep its picture. Members are not notified again. One request, never retried. Once VRChat accepts, the audit log records who changed it. Needs the `ManageGroupPosts` permission.
Create group role POST
Create a role in the group on VRChat. `name` is required; `description` and `permissions` (VRChat's ids) are optional. One request, never retried; a refusal answers with VRChat's own message, and a 403 for a permission Modbot's VRChat account lacks names it in `missingGroupPermission`. Once VRChat accepts, the audit log records who created it. Needs the `ManageGroupRoles` permission.