Set user roles
/api/users/{id}/rolesReplace an account's roles. Takes effect on that person's next request, not their next sign-in. Refused unless the account's highest role is below yours, and for any role added or taken away that is not below your highest role.
Needs the ManageUsers permission.
An API key, made on Settings, API keys. Every key starts with mbk_.
In: header
Path Parameters
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/users/497f6eca-6276-4993-bfeb-53cbbbba6f08/roles" \ -H "Content-Type: application/json" \ -d '{ "roleIds": [ "10960216-a894-4481-b8f2-270c1c8fab34" ] }'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "username": "string", "roles": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string" } ], "permissionNames": [ "string" ], "isDisabled": true, "isDeleted": true, "vrChatLinked": true, "vrChatUserId": null, "vrChatDisplayName": null, "email": null, "discordUserId": null, "discordUsername": null, "discordProven": true, "discordWorksUntil": null, "createdAt": "2019-08-24T14:15:22Z", "lastLoginAt": null, "rank": null, "rolesFromDiscord": null}Add user POST
Create an account with a temporary password. The administrator passes the password on. Until the person changes it, this is an account two people can act as -- prefer an invite link, which is why the users page offers that first. Needs the `ManageUsers` permission.
Disable user POST
Disable an account and end its sessions. Never delete: facts reference the account. Refused for your own account and for the last enabled administrator, and for an account whose highest role is not below yours. Needs the `ManageUsers` permission.