Update staff role from Discord
PUT
/api/staff-roles/{id}Change which Discord role gives which Modbot role, or which way it works.
Needs the ManageUsers and ManageRoles permissions.
AuthorizationBearer <token>
An API key, made on Settings, API keys. Every key starts with mbk_.
In: header
Path Parameters
id*string
Format
uuidRequest 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 PUT "https://example.com/api/staff-roles/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Content-Type: application/json" \ -d '{ "discordRoleId": "string", "roleId": "7382d58e-652a-4905-b7c9-bcca1e0e5391", "direction": "string" }'{ "on": true, "ranAt": null, "problem": null, "heldAt": null, "heldCount": null, "mappings": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "discordRoleId": "string", "discordRoleName": null, "roleId": "7382d58e-652a-4905-b7c9-bcca1e0e5391", "roleName": "string", "direction": "string", "notSetUp": true, "canChange": true, "problem": null } ], "roles": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "position": 0, "canMap": true } ]}Delete staff role from Discord DELETE
Stop a Discord role giving a Modbot role. Nobody's roles change. Needs the `ManageUsers` and `ManageRoles` permissions.
Switch staff roles from Discord PUT
Turn giving and taking Modbot roles from Discord roles on or off. Needs the `ManageUsers` and `ManageRoles` permissions.