diff --git a/‎docs/api-usage.rst‎
Lines changed: 10 additions & 0 deletions b/‎docs/api-usage.rst‎
Lines changed: 10 additions & 0 deletions
diff --git a/‎docs/cli.rst‎
Lines changed: 6 additions & 0 deletions b/‎docs/cli.rst‎
Lines changed: 6 additions & 0 deletions
diff --git a/‎gitlab/cli.py‎
Lines changed: 1 addition & 0 deletions b/‎gitlab/cli.py‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎gitlab/objects.py‎
Lines changed: 1 addition & 0 deletions b/‎gitlab/objects.py‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎tools/python_test.py‎
Lines changed: 2 additions & 1 deletion b/‎tools/python_test.py‎
Lines changed: 2 additions & 1 deletion
@@ -117,3 +117,13 @@ Use the ``all`` parameter to get all the items:
 .. code-block:: python
 
    all_groups = gl.groups.list(all=True)
+
+Sudo
+====
+
+If you have the administrator status, you can use ``sudo`` to act as another
+user. For example:
+
+.. code-block:: python
+
+   p = gl.projects.create({'name': 'awesome_project'}, sudo='user1')
@@ -189,3 +189,9 @@ Define the status of a commit (as would be done from a CI tool for example):
        --commit-id a43290c --state success --name ci/jenkins \
        --target-url http://server/build/123 \
        --description "Jenkins build succeeded"
+
+Use sudo to act as another user (admin only):
+
+.. code-block:: console
+
+   $ gitlab project create --name user_project1 --sudo username
@@ -73,6 +73,7 @@ def _populate_sub_parser_by_class(cls, sub_parser):
         [sub_parser_action.add_argument("--%s" % x.replace('_', '-'),
                                         required=True)
          for x in cls.requiredUrlAttrs]
+        sub_parser_action.add_argument("--sudo", required=False)
 
         if action_name == LIST:
             [sub_parser_action.add_argument("--%s" % x.replace('_', '-'),
 
@@ -227,6 +227,7 @@ def _data_for_gitlab(self, extra_parameters={}, update=False):
         else:
             attributes = itertools.chain(self.requiredCreateAttrs,
                                          self.optionalCreateAttrs)
+        attributes = list(attributes) + ['sudo', 'page', 'per_page']
         for attribute in attributes:
             if hasattr(self, attribute):
                 data[attribute] = getattr(self, attribute)
 
@@ -98,8 +98,9 @@
                                   'namespace_id': group1.id})
 gr2_project = gl.projects.create({'name': 'gr2_project',
                                   'namespace_id': group2.id})
+sudo_project = gl.projects.create({'name': 'sudo_project'}, sudo=user1.name)
 
-assert(len(gl.projects.all()) == 3)
+assert(len(gl.projects.all()) == 4)
 assert(len(gl.projects.owned()) == 2)
 assert(len(gl.projects.search("admin")) == 1)