feat(user): add status apifeat/status-api

1 files changed, 38 insertions, 0 deletions

diff --git a/docs/gl_objects/users.rst b/docs/gl_objects/users.rst
index e66ef3a..a276ce1 100644
--- a/docs/gl_objects/users.rst
+++ b/docs/gl_objects/users.rst
@@ -250,6 +250,44 @@ Delete an SSH key for a user::
     # or
     key.delete()
 
+Status
+======
+
+References
+----------
+
+You can manipulate SSH keys for the current user and for the other users if you
+are admin.
+
+* v4 API:
+
+  + :class:`gitlab.v4.objects.CurrentUserStatus`
+  + :class:`gitlab.v4.objects.CurrentUserStatusManager`
+  + :attr:`gitlab.v4.objects.CurrentUser.status`
+  + :class:`gitlab.v4.objects.UserStatus`
+  + :class:`gitlab.v4.objects.UserStatusManager`
+  + :attr:`gitlab.v4.objects.User.status`
+
+* GitLab API: https://docs.gitlab.com/ce/api/users.html#user-status
+
+Examples
+--------
+
+Get current user status::
+
+    status = user.status.get()
+
+Update the status for the current user::
+
+    status = user.status.get()
+    status.message = "message"
+    status.emoji = "thumbsup"
+    status.save()
+
+Get the status of other users::
+
+    gl.users.get(1).status.get()
+
 Emails
 ======