public/grafana
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Docs: Update the docs for folder creation permissions (#92703)

Browse Source 
* update the docs to reflect permissions needed to create subfolders

* Minor language fix

---------

Co-authored-by: Irene Rodriguez <irene.rodriguez@grafana.com>
This commit is contained in:
Ieva
2024-08-30 10:55:32 +00:00
committed by GitHub
co-authored by Irene Rodriguez
parent 152d3540db
commit b99d1249db
4 changed files with 12 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/sources/developers/http_api/folder.md
+6 -6
View File
@@ -143,11 +143,11 @@ Creates a new folder.
See note in the [introduction]({{< ref "#folder-api" >}}) for an explanation.
`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`.
`folders:create` allows creating folders and subfolders. If granted with scope `folders:uid:general`, allows creating root level folders. Otherwise, allows creating subfolders under the specified folders.
| Action | Scope |
| ---------------- | ----------- |
| `folders:create` | n/a |
| `folders:create` | `folders:*` |
| `folders:write` | `folders:*` |
**Example Request**:
@@ -411,14 +411,14 @@ See note in the [introduction]({{< ref "#folder-api" >}}) for an explanation.
If moving the folder under another folder:
| Action | Scope |
| --------------- | -------------------------------------- |
| `folders:write` | `folders:uid:<destination folder UID>` |
| Action | Scope |
| ---------------- | ----------------------------------------------------- |
| `folders:create` | `folders:uid:<destination folder UID>`<br>`folders:*` |
If moving the folder under root:
| Action | Scope |
| -------------- | ------------- |
| `folders:create` | `folders:*` |
| `folders:create` | `folders:uid:general`<br>`folders:*` |
JSON body schema: