Modbot Docs
APIAPI referenceSettings

List ban reasons

GET/api/settings/ban-reasons

The reasons a moderator picks from when banning, kicking, unbanning or turning a join request down; usedFor says which actions offer each one. In button order, switched-off ones included with isActive false. Seeded with a plain default set the first time anybody asks, so the first case file can be written without inventing a list first. reasonAlwaysRequired says whether the actions other than a ban need a reason too.

AuthorizationBearer <token>

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

In: header

Response Body

application/json

application/problem+json

curl -X GET "https://example.com/api/settings/ban-reasons"
{  "reasons": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "label": "string",      "description": "string",      "sortOrder": 0,      "isActive": true,      "needsWrittenReason": true,      "usedFor": [        "string"      ]    }  ],  "canEdit": true,  "reasonAlwaysRequired": 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.