Modbot Docs
APIAPI referenceGroup page

List group roles

GET/api/group/roles

The 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.

AuthorizationBearer <token>

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"}

Modbot is not endorsed by or affiliated with VRChat Inc. or Discord Inc. VRChat is a trademark of VRChat Inc. Discord is a trademark of Discord Inc. SteamVR is a trademark of Valve Corporation. Windows is a trademark of Microsoft Corporation. Docker is a trademark of Docker, Inc. PostgreSQL is a trademark of the PostgreSQL Community Association of Canada. Railway is a trademark of Railway Corp. Other names are trademarks of their respective owners; see Legal. Modbot and its logo are trademarks of the Modbot project. Open source under AGPL-3.0.