Modbot Docs
APIAPI referenceGroup page

Update group role

Deprecated

PUT/api/group/roles

Change a role: id names it. Leave name, description or permissions out to keep them; permissions is the whole list, which VRChat replaces. Only the fields that differ from what Modbot last recorded are sent. One request, never retried. Once VRChat accepts, the audit log records who changed it and each field's old and new value.

Needs the ManageGroupRoles permission.

Kept for older clients: use PUT /api/group/roles/{id}.

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 PUT "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.