Merge pull request #4092 from Joshua-Anderson/perms-doc-fix

docs(reference): fix mistakes in perms section of api docs

Author: carmstrong

docs/reference/api-v1.5.rst

@@ -1248,6 +1248,10 @@ Permissions
 List Application Permissions
 ````````````````````````````
 
+.. note::
+
+    This does not include the app owner.
+
 Example Request:
 
 .. code-block:: console
@@ -1266,7 +1270,10 @@ Example Response:
     Content-Type: application/json
 
     {
-        "users": []
+        "users": [
+            "test",
+            "foo"
+        ]
     }
 
 
@@ -1299,7 +1306,7 @@ Example Request:
 
 .. code-block:: console
 
-    POST /v1/apps/example-go/perms/example HTTP/1.1
+    DELETE /v1/apps/example-go/perms/example HTTP/1.1
     Host: deis.example.com
     Authorization: token abc123
 
@@ -1311,6 +1318,43 @@ Example Response:
     DEIS_API_VERSION: 1.5
     DEIS_PLATFORM_VERSION: 1.8.0
 
+List Administrators
+```````````````````
+
+Example Request:
+
+.. code-block:: console
+
+    GET /v1/admin/perms/ HTTP/1.1
+    Host: deis.example.com
+    Authorization: token abc123
+
+Example Response:
+
+.. code-block:: console
+
+    HTTP/1.1 200 OK
+    DEIS_API_VERSION: 1.5
+    DEIS_PLATFORM_VERSION: 1.8.0
+    Content-Type: application/json
+
+    {
+        "count": 2,
+        "next": null
+        "previous": null,
+        "results": [
+            {
+                "username": "test",
+                "is_superuser": true
+            },
+            {
+                "username": "foo",
+                "is_superuser": true
+            }
+        ]
+    }
+
+
 Grant User Administrative Privileges
 ````````````````````````````````````
 
@@ -1336,6 +1380,29 @@ Example Response:
     DEIS_API_VERSION: 1.5
     DEIS_PLATFORM_VERSION: 1.8.0
 
+Remove User's Administrative Privileges
+```````````````````````````````````````
+
+.. note::
+
+    This command requires administrative privileges
+
+Example Request:
+
+.. code-block:: console
+
+    DELETE /v1/admin/perms/example HTTP/1.1
+    Host: deis.example.com
+    Authorization: token abc123
+
+Example Response:
+
+.. code-block:: console
+
+    HTTP/1.1 204 NO CONTENT
+    DEIS_API_VERSION: 1.5
+    DEIS_PLATFORM_VERSION: 1.8.0
+
 Users
 -----