Appearance
Add a folder
About 277 wordsLess than 1 minute
apiFolders
2025-09-15
MethodPOST
Request URL
/plugin/datafor-modeler/api/repo/dirs/addAuthorization
The current user must have administrator authority over the parent folder.
Content Typeapplication/json
Request Example
{
"aces": [
{
"recipient": "admin",
"tenantPath": null,
"modifiable": true,
"recipientType": 0,
"permissions": [
4
]
}
],
"id": null,
"owner": "admin",
"tenantPath": null,
"ownerType": 0,
"entriesInheriting": false
}| Name | Location | Type | Required | Description |
|---|---|---|---|---|
pathId | query | string | No | Parent folder path where the new folder will be created. |
body | body | object | No | JSON payload for folder creation. |
aces | body | array | Yes | List of access control entries (ACL). |
recipient | body | string | No | User or role receiving permissions. |
tenantPath | body | null | No | Tenant path (if applicable). |
modifiable | body | boolean | No | Whether the ACL is modifiable. |
recipientType | body | integer | No | Type of recipient (e.g., user or role). |
permissions | body | array | No | List of permission levels assigned. |
id | body | null | No | Folder ID (set to null for new folder). |
owner | body | string | Yes | Owner of the folder. |
tenantPath | body | null | No | Tenant path (if applicable). |
ownerType | body | integer | Yes | Owner type identifier. |
entriesInheriting | body | boolean | Yes | Whether the folder inherits permissions from its parent. |
Response Examples
✅ Success Response
{
"code": 200,
"success": true
}HTTP Responses
| HTTP Status Code | Meaning | Description |
|---|---|---|
| 200 | OK | Folder created successfully. |
| 400 | Bad Request | Invalid request format or missing parameters. |
| 401 | Unauthorized | Authentication required. |
| 403 | Forbidden | User lacks the required permissions. |
| 500 | Internal Server Error | Unexpected error occurred. |
Response Data Schema
| Name | Type | Required | Description |
|---|---|---|---|
code | integer | No | HTTP response code. |
success | boolean | Yes | true if the folder was successfully created, false otherwise. |