Modbot Docs

Move role

POST/api/roles/{id}/move

Move a role one place up or down in the order. A person's rank is their highest role. Refused for a role that is not below your highest role, and for a move that would put a role at your own place or above it. Administrator is always first. Returns the roles in their new order.

Needs the ManageRoles permission.

AuthorizationBearer <token>

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

In: header

Path Parameters

id*string
Formatuuid

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

curl -X POST "https://example.com/api/roles/497f6eca-6276-4993-bfeb-53cbbbba6f08/move" \  -H "Content-Type: application/json" \  -d '{    "direction": "string"  }'
{  "roles": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "description": "string",      "permissionNames": [        "string"      ],      "isBuiltIn": true,      "locked": true,      "userCount": 0,      "position": 0    }  ],  "permissions": [    {      "name": "string",      "value": 0,      "label": "string",      "description": "string",      "group": "string"    }  ]}

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.