Modbot Docs
APIAPI referenceGroup page

Create group role

POST/api/group/roles

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.

AuthorizationBearer <token>

An API key, made on Settings, API keys. Every key starts with mbk_.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/api/group/roles" \  -H "Content-Type: application/json" \  -d '{    "id": null,    "name": null,    "description": null,    "permissions": null  }'
{  "role": {    "id": "string",    "name": null,    "description": null,    "permissions": [      "string"    ],    "order": 0,    "isDefault": true,    "isManagementRole": true,    "isSelfAssignable": true,    "requiresTwoFactor": true,    "heldByModbot": true  }}

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.