Add

[POST] .../v1/folder/add

Creates a new folder. Create a personal or public folder in REGOS file storage before uploading files into it. The request body is required, name is required, parent_id is optional and defaults to the root folder and access_level defaults to personal when it is not sent. The method validates that the parent folder exists, the current request user can write into it, the folder tree depth does not exceed five levels and the same owner does not already have an active folder with the same name in that parent. The caller must have folder add permission and the folders module must be available; missing body, invalid name or access_level, denied permission, unavailable feature, duplicate folder names, parent ACL failures, depth violations and storage errors are returned as HTTP 200 ErrorResult.

Request Parameters

Request Example

{
  "name": "Invoices",
  "parent_id": 1,
  "access_level": "personal"
}

Response Parameters

Response Example

{
  "ok": true,
  "result": {
    "new_id": 10
  }
}