A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z | AA | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | |||||||||||||||||||||||||||
2 | For APIv4 specification, see https://docs.google.com/document/d/197JwEBMnK8okFilTfGSpbsrXPY5RZOJ4gG2DXwcbwYE/edit | ||||||||||||||||||||||||||
3 | |||||||||||||||||||||||||||
4 | |||||||||||||||||||||||||||
5 | Color codes | Completed | In progress | Not started | |||||||||||||||||||||||
6 | |||||||||||||||||||||||||||
7 | User Endpoints (see tabs at bottom for more sections) | ||||||||||||||||||||||||||
8 | |||||||||||||||||||||||||||
9 | METHOD | ENDPOINT | DESCRIPTION | REQUEST BODY | QUERY PARAMETERS | RESPONSE | PERMISSION | CONTRIBUTOR | LINK TO PR | ||||||||||||||||||
10 | POST | /users | Create a user. | User | User | jwilander | https://github.com/mattermost/platform/pull/5191 | 3.7 | |||||||||||||||||||
11 | PUT | /users/{user_id} | Update a user. | User | User | Self or "edit_other_users" | jwilander | https://github.com/mattermost/platform/pull/5191 | 3.7 | ||||||||||||||||||
12 | PUT | /users/{user_id}/patch | Partially update a user. | Partial user | User | Self or "edit_other_users" | jwilander | https://github.com/mattermost/platform/pull/5418 | 3.7 | ||||||||||||||||||
13 | PUT | /users/{user_id}/roles | Update a user's roles. | Roles | OK | "manage_roles" | jwilander | https://github.com/mattermost/platform/pull/5238 | 3.7 | ||||||||||||||||||
14 | PUT | /users/{user_id}/password | Update a user's password. | Current password, old password | OK | Self or "manage_system" | jwilander | https://github.com/mattermost/platform/pull/5243 | 3.7 | ||||||||||||||||||
15 | POST | /users/password/reset | Reset a user's password. | Recovery code, new password | OK | None, but must include vaild recovery code | jwilander | https://github.com/mattermost/platform/pull/5256 | 3.7 | ||||||||||||||||||
16 | POST | /users/password/reset/send | Send a reset password email to a user. | OK | jwilander | https://github.com/mattermost/platform/pull/5256 | 3.7 | ||||||||||||||||||||
17 | GET | /users | Get a page of users as an array. | page per_page in_channel in_team not_in_channel | User list | Logged in | jwilander | https://github.com/mattermost/platform/pull/5277 | 3.7 | ||||||||||||||||||
18 | GET | /users/{user_id} | Get a single user. | User | Logged in | jwilander | https://github.com/mattermost/platform/pull/5191 | 3.7 | |||||||||||||||||||
19 | GET | /users/username/{username} | Get a user by username. | User | Logged in | ruzette | https://github.com/mattermost/platform/pull/5310 | 3.7 | |||||||||||||||||||
20 | GET | /users/email/{email} | Get a user by email. | User | Logged in | ruzette | https://github.com/mattermost/platform/pull/5309 | 3.7 | |||||||||||||||||||
21 | POST | /users/ids | Get a list of users matching the provided ids. | List of user ids | User list | Logged in | jwilander | https://github.com/mattermost/platform/pull/5274 | 3.7 | ||||||||||||||||||
22 | POST | /users/search | Get a list of users based on search criteria provided in the request body. | UserSearch | User list | Logged in | jwilander | https://github.com/mattermost/platform/pull/5822 | 3.8 | ||||||||||||||||||
23 | GET | /users/autocomplete | Get a list of users for the purpose of autocompleting based on the provided term. | name in_channel in_team | User list | Logged in | jwilander | https://github.com/mattermost/platform/pull/5742 | 3.8 | ||||||||||||||||||
24 | POST | /users/{user_id}/email/verify | Verify a user's email address. | user_id hash | OK | None, but hash must match user id + salt | cpanato | https://github.com/mattermost/platform/pull/5502 | 3.7 | ||||||||||||||||||
25 | POST | /users/email/verify/send | Send a verification email to a user. | OK | jwilander | https://github.com/mattermost/platform/pull/5825 | 3.8 | ||||||||||||||||||||
26 | POST | /users/{user_id}/image | Upload a profile image for a user. | Multipart form | OK | Self, or "edit_other_users" | saturninoabril | https://github.com/mattermost/platform/pull/5537 | 3.7 | ||||||||||||||||||
27 | GET | /users/{user_id}/image | Get a user's profile image. | Image bytes | Logged in | saturninoabril | https://github.com/mattermost/platform/pull/5526 | 3.7 | |||||||||||||||||||
28 | POST | /users/login | Log a user in. | User | jwilander | https://github.com/mattermost/platform/pull/5191 | 3.7 | ||||||||||||||||||||
29 | POST | /users/logout | Log a user out. | OK | jwilander | https://github.com/mattermost/platform/pull/5191 | 3.7 | ||||||||||||||||||||
30 | POST | /users/login/switch | Switch a user's login types. | Info about type to switch to | OK | jwilander | https://github.com/mattermost/platform/pull/6000 | 3.9 | |||||||||||||||||||
31 | GET | /users/{user_id}/sessions | Get a list of sessions for a user. | Session list | Self, or "edit_other_users" | ruzette | https://github.com/mattermost/platform/pull/5449 | 3.7 | |||||||||||||||||||
32 | POST | /users/{user_id}/sessions/revoke | Revoke a session for a user. | Session id | OK | Self, or "edit_other_users" | ruzette | https://github.com/mattermost/platform/pull/5449 | 3.7 | ||||||||||||||||||
33 | GET | /users/{user_id}/audits | Get a list of audits for a user. | Audit list | Self, or "edit_other_users" | saturninoabril | https://github.com/mattermost/platform/pull/5472 | 3.7 | |||||||||||||||||||
34 | PUT | /users/sessions/device | Attach a user's mobile device ID to their current session. | Device id | OK | Self | jwilander | https://github.com/mattermost/platform/pull/5866 | 3.8 | ||||||||||||||||||
35 | POST | /users/mfa | Get whether a user has MFA activated. | login_id | { "mfa_required": bool } | jwilander | https://github.com/mattermost/platform/pull/5864 | 3.8 | |||||||||||||||||||
36 | PUT | /users/{user_id}/mfa | Update a user's MFA. | Boolean for on/off, token | OK | Self, or "edit_other_users" | jwilander | https://github.com/mattermost/platform/pull/5743 | 3.8 | ||||||||||||||||||
37 | POST | /users/{user_id}/mfa/generate | Generate a new MFA secret for a user. | { "qr_code": string, "secret": string } | Logged in | jwilander | https://github.com/mattermost/platform/pull/5864 | 3.8 | |||||||||||||||||||
38 | DELETE | /users/{user_id} | Deactivate a user account. | OK | Self, or "edit_other_users" | ruzette | https://github.com/mattermost/platform/pull/5307 | 3.7 | |||||||||||||||||||
39 | |||||||||||||||||||||||||||
40 | |||||||||||||||||||||||||||
41 | |||||||||||||||||||||||||||
42 | |||||||||||||||||||||||||||
43 | |||||||||||||||||||||||||||
44 | |||||||||||||||||||||||||||
45 | |||||||||||||||||||||||||||
46 | |||||||||||||||||||||||||||
47 | |||||||||||||||||||||||||||
48 | |||||||||||||||||||||||||||
49 | |||||||||||||||||||||||||||
50 | |||||||||||||||||||||||||||
51 | |||||||||||||||||||||||||||
52 | |||||||||||||||||||||||||||
53 | |||||||||||||||||||||||||||
54 | |||||||||||||||||||||||||||
55 | |||||||||||||||||||||||||||
56 | |||||||||||||||||||||||||||
57 | |||||||||||||||||||||||||||
58 | |||||||||||||||||||||||||||
59 | |||||||||||||||||||||||||||
60 | |||||||||||||||||||||||||||
61 | |||||||||||||||||||||||||||
62 | |||||||||||||||||||||||||||
63 | |||||||||||||||||||||||||||
64 | |||||||||||||||||||||||||||
65 | |||||||||||||||||||||||||||
66 | |||||||||||||||||||||||||||
67 | |||||||||||||||||||||||||||
68 | |||||||||||||||||||||||||||
69 | |||||||||||||||||||||||||||
70 | |||||||||||||||||||||||||||
71 | |||||||||||||||||||||||||||
72 | |||||||||||||||||||||||||||
73 | |||||||||||||||||||||||||||
74 | |||||||||||||||||||||||||||
75 | |||||||||||||||||||||||||||
76 | |||||||||||||||||||||||||||
77 | |||||||||||||||||||||||||||
78 | |||||||||||||||||||||||||||
79 | |||||||||||||||||||||||||||
80 | |||||||||||||||||||||||||||
81 | |||||||||||||||||||||||||||
82 | |||||||||||||||||||||||||||
83 | |||||||||||||||||||||||||||
84 | |||||||||||||||||||||||||||
85 | |||||||||||||||||||||||||||
86 | |||||||||||||||||||||||||||
87 | |||||||||||||||||||||||||||
88 | |||||||||||||||||||||||||||
89 | |||||||||||||||||||||||||||
90 | |||||||||||||||||||||||||||
91 | |||||||||||||||||||||||||||
92 | |||||||||||||||||||||||||||
93 | |||||||||||||||||||||||||||
94 | |||||||||||||||||||||||||||
95 | |||||||||||||||||||||||||||
96 | |||||||||||||||||||||||||||
97 | |||||||||||||||||||||||||||
98 | |||||||||||||||||||||||||||
99 | |||||||||||||||||||||||||||
100 |