Docs: Documentation updates for nested folder permissions (#66599)

doc updates for nested folder permissions
2023-04-21 06:29:52 -04:00
parent 9f1fe51edc
commit 9a29dd7d6e
5 changed files with 151 additions and 138 deletions
@@ -135,9 +135,12 @@ Creates a new folder.

 See note in the [introduction]({{< ref "#folder-api" >}}) for an explanation.

-| Action           | Scope |
-| ---------------- | ----- |
-| `folders:create` | n/a   |
+`folders:create` allows creating folders in the root level. To create a subfolder, `folders:write` scoped to the parent folder is required in addition to `folders:create`.
+
+| Action           | Scope       |
+| ---------------- | ----------- |
+| `folders:create` | n/a         |
+| `folders:write`  | `folders:*` |

 **Example Request**: