From aff4653454ff45f7ccd994f1a14ddbac93e8394c Mon Sep 17 00:00:00 2001 From: Luna Date: Mon, 22 Apr 2019 00:31:54 -0300 Subject: [PATCH] docs/admin_api.md: add PATCH /users/:id to docs --- docs/admin_api.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/docs/admin_api.md b/docs/admin_api.md index 6a04aff..1dd37a4 100644 --- a/docs/admin_api.md +++ b/docs/admin_api.md @@ -48,6 +48,26 @@ Output: | old | user object | old user object pre-delete | | new | user object | new user object post-delete | +### PATCH `/users/` + +Update a single user's information. + +Returns a user object on success. + +**Note:** You can not change any user's staff badge state (neither adding +it or removing it) to not cause privilege escalation/de-escalation (where +a staff makes more staff or a staff removes staff privileges of someone else). +Keep in mind the staff badge is what grants access to the Admin API, so. + +**Note:** Changing a user's nitro badge is not defined via the flags. +Plus that would require adding an interface to user payments +through the Admin API. + +[UserFlags]: https://discordapp.com/developers/docs/resources/user#user-object-user-flags + +| field | type | description | +| --: | :-- | :-- | +| flags | [UserFlags] | user flags/badges | ## Instance invites