Update roles from lists
/api/discord-list-rolesSwitch roles from lists on or off. Off gives and takes nothing.
Needs the ManageDiscordSync permission.
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
curl -X PUT "https://example.com/api/discord-list-roles" \ -H "Content-Type: application/json" \ -d '{ "on": true }'{ "on": true, "botCanManageRoles": true, "ranAt": null, "problem": null, "roles": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "listId": "9fc6ad7d-902a-4834-b161-a4911b883d44", "listName": "string", "discordRoleId": "string", "roleName": null, "enabled": true, "given": 0, "problem": null, "stoppedAt": null, "stoppedTaking": null, "removalsAllowed": null } ], "lists": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string" } ], "canPreview": true, "canApply": true}Add role from a list POST
Give a Discord role to everybody in a saved list who is in the server, and take it from those it gave it to once they leave the list. Refused for @everyone, a bot's role, a role the bot cannot give, a role with a staff permission, a role something else already gives, and a list that lets everybody in. Needs what the preview needs, since saving follows it. Needs the `ViewMembers` and `ViewProfile` and `ManageDiscordSync` permissions.
Delete role from a list DELETE
Stop a list giving a Discord role. Nobody loses the role: Modbot forgets who it gave it to, and the role stays with everybody who has it. Needs the `ManageDiscordSync` permission.