v3: Document app permissions endpoint

[#169770887]

Co-authored-by: Belinda Liu <bliu@pivotal.io>
Co-authored-by: Reid Mitchell <rmitchell@pivotal.io>

Author: belinda-liu

docs/v3/source/includes/resources/apps/_permissions.md.erb

@@ -0,0 +1,43 @@
+### Get permissions
+
+```
+Example Request
+```
+
+```shell
+curl "https://api.example.org/v3/apps/[guid]/permissions" \
+  -X GET \
+  -H "Authorization: bearer [token]"
+```
+
+```
+Example Response
+```
+
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+  "read_basic_data": true,
+  "read_sensitive_data": false
+}
+```
+
+Get the current user's permissions for the given app. If a user can see an app,
+then they can see its basic data. Only admin and read-only admins can read sensitive
+data.
+
+#### Definition
+`GET /v3/apps/:guid/permissions`
+
+#### Permitted roles
+ |
+--- | ---
+Admin |
+Admin Read-Only |
+Global Auditor |
+Org Manager |
+Space Auditor |
+Space Developer |
+Space Manager |

docs/v3/source/index.md

@@ -68,6 +68,7 @@ includes:
   - resources/apps/get_current_droplet_relationship
   - resources/apps/env
   - resources/apps/environment_variables
+  - resources/apps/permissions
   - resources/apps/current_droplet
   - resources/apps/ssh_enabled
   - resources/apps/start