docs: update API documentation.

docs/api/methods/pull-request-methods.rst

@@ -25,8 +25,7 b' close_pull_request'
    .. code-block:: bash
 
      "id": <id_given_in_input>,
-     "result":
-       {
+       "result": {
            "pull_request_id":  "<int>",
            "closed":           "<bool>"
        },
@@ -68,13 +67,12 b' comment_pull_request'
    .. code-block:: bash
 
      id : <id_given_in_input>
-     result :
-       {
+       result : {
            "pull_request_id":  "<Integer>",
            "comment_id":       "<Integer>",
            "status": {"given": <given_status>,
                       "was_changed": <bool status_was_actually_changed> },
-       }
+       },
      error :  null
 
 
@@ -109,9 +107,8 b' create_pull_request'
    :param reviewers: Set the new pull request reviewers list.
    :type reviewers: Optional(list)
        Accepts username strings or objects of the format:
-       {
-           'username': 'nick', 'reasons': ['original author']
-       }
+
+           {'username': 'nick', 'reasons': ['original author']}
 
 
 get_pull_request 
@@ -306,8 +303,7 b' merge_pull_request'
    .. code-block:: bash
 
      "id": <id_given_in_input>,
-     "result":
-       {
+       "result": {
            "executed":         "<bool>",
            "failure_reason":   "<int>",
            "merge_commit_id":  "<merge_commit_id>",
@@ -350,8 +346,7 b' update_pull_request'
    .. code-block:: bash
 
      id : <id_given_in_input>
-     result :
-       {
+       result : {
            "msg": "Updated pull request `63`",
            "pull_request": <pull_request_object>,
            "updated_reviewers": {

docs/api/methods/server-methods.rst

@@ -85,6 +85,58 b' get_ip'
        }
 
 
+get_method 
+----------
+
+.. py:function:: get_method(apiuser, pattern=<Optional:'*'>)
+
+   Returns list of all available API methods. By default match pattern
+   os "*" but any other pattern can be specified. eg *comment* will return
+   all methods with comment inside them. If just single method is matched
+   returned data will also include method specification
+
+   This command can only be run using an |authtoken| with admin rights to
+   the specified repository.
+
+   This command takes the following options:
+
+   :param apiuser: This is filled automatically from the |authtoken|.
+   :type apiuser: AuthUser
+   :param pattern: pattern to match method names against
+   :type older_then: Optional("*")
+
+   Example output:
+
+   .. code-block:: bash
+
+     id : <id_given_in_input>
+     "result": [
+       "changeset_comment",
+       "comment_pull_request",
+       "comment_commit"
+     ]
+     error :  null
+
+   .. code-block:: bash
+
+     id : <id_given_in_input>
+     "result": [
+       "comment_commit",
+       {
+         "apiuser": "<RequiredType>",
+         "comment_type": "<Optional:u'note'>",
+         "commit_id": "<RequiredType>",
+         "message": "<RequiredType>",
+         "repoid": "<RequiredType>",
+         "request": "<RequiredType>",
+         "resolves_comment_id": "<Optional:None>",
+         "status": "<Optional:None>",
+         "userid": "<Optional:<OptionalAttr:apiuser>>"
+       }
+     ]
+     error :  null
+
+
 get_server_info 
 ---------------
 

docs/api/methods/user-methods.rst

@@ -41,6 +41,7 b' create_user'
    :type force_password_change: Optional(``True`` | ``False``)
    :param create_personal_repo_group: Create personal repo group for this user
    :type create_personal_repo_group: Optional(``True`` | ``False``)
+
    Example output:
 
    .. code-block:: bash
@@ -145,8 +146,8 b' get_user'
          "result": {
            "active": true,
            "admin": false,
-           "api_key": "api-key",
            "api_keys": [ list of keys ],
+           "auth_tokens": [ list of tokens with details ],
            "email": "[e-mail]",
            "emails": [
              "[e-mail]"
@@ -157,6 +158,7 b' get_user'
            "ip_addresses": [],
            "language": null,
            "last_login": "Timestamp",
+           "last_activity": "Timestamp",
            "lastname": "surnae",
            "permissions": {
              "global": [
@@ -183,6 +185,32 b' get_user'
        }
 
 
+get_user_audit_logs 
+-------------------
+
+.. py:function:: get_user_audit_logs(apiuser, userid=<Optional:<OptionalAttr:apiuser>>)
+
+   Fetches all action logs made by the specified user.
+
+   This command takes the following options:
+
+   :param apiuser: This is filled automatically from the |authtoken|.
+   :type apiuser: AuthUser
+   :param userid: Sets the userid whose list of locked |repos| will be
+       displayed.
+   :type userid: Optional(str or int)
+
+   Example output:
+
+   .. code-block:: bash
+
+       id : <id_given_in_input>
+       result : {
+           [action, action,...]
+       }
+       error :  null
+
+
 get_user_locks 
 --------------
 

rhodecode/api/views/pull_request_api.py

@@ -245,8 +245,7 b' def merge_pull_request(request, apiuser,'
     .. code-block:: bash
 
       "id": <id_given_in_input>,
-      "result":
-        {
+        "result": {
             "executed":         "<bool>",
             "failure_reason":   "<int>",
             "merge_commit_id":  "<merge_commit_id>",
@@ -258,7 +257,6 b' def merge_pull_request(request, apiuser,'
                                 }
         },
       "error": null
-
     """
     repo = get_repo_or_error(repoid)
     if not isinstance(userid, Optional):
@@ -322,8 +320,7 b' def close_pull_request(request, apiuser,'
     .. code-block:: bash
 
       "id": <id_given_in_input>,
-      "result":
-        {
+        "result": {
             "pull_request_id":  "<int>",
             "closed":           "<bool>"
         },
@@ -397,13 +394,12 b' def comment_pull_request('
     .. code-block:: bash
 
       id : <id_given_in_input>
-      result :
-        {
+        result : {
             "pull_request_id":  "<Integer>",
             "comment_id":       "<Integer>",
             "status": {"given": <given_status>,
                        "was_changed": <bool status_was_actually_changed> },
-        }
+        },
       error :  null
     """
     repo = get_repo_or_error(repoid)
@@ -535,9 +531,8 b' def create_pull_request('
     :param reviewers: Set the new pull request reviewers list.
     :type reviewers: Optional(list)
         Accepts username strings or objects of the format:
-        {
-            'username': 'nick', 'reasons': ['original author']
-        }
+
+            {'username': 'nick', 'reasons': ['original author']}
     """
 
     source = get_repo_or_error(source_repo)
@@ -634,8 +629,7 b' def update_pull_request('
     .. code-block:: bash
 
       id : <id_given_in_input>
-      result :
-        {
+        result : {
             "msg": "Updated pull request `63`",
             "pull_request": <pull_request_object>,
             "updated_reviewers": {

rhodecode/api/views/user_api.py

@@ -191,6 +191,7 b' def create_user(request, apiuser, userna'
     :type force_password_change: Optional(``True`` | ``False``)
     :param create_personal_repo_group: Create personal repo group for this user
     :type create_personal_repo_group: Optional(``True`` | ``False``)
+
     Example output:
 
     .. code-block:: bash