POST /ws/rest/service/v1/dm/folder/create/<parent_folder_id>
Purpose
This service allows user to create folders under a specific folder. The parent folder is specified as node id in the service call's path parameter.
Input:
Path Parameter
- parent_folder_id : Parent folder's node id under which the folders will be created.
- Use “Get Folder or Document meta data by path” REST Service to get the node_id value for the parent folder.
Form Data (Content Type : application/x-www-form-urlencoded)
- data (JSON String) Required: List of field and values for the folder attribute form.
- Name (Required): Name of the folder to create.
- Folder names should be 255 characters or less. Names that will not be supported are those that contain non-printable ascii, / or \, names with trailing spaces, and the special names “.” and “..”
- Other fields are optional/required based on the attribute form design.
Example:
URL:http://unifier-intg.oracle.com/ws/rest/dm/folder/create/2002896
To create a folder REST Folder" under "/Project Documents/Service docs" whose node id (2002896) is specified in path parameter then data should as below
data:[ {"Name":"REST Folder","Owner":"Company Administrator","Creation Date":"01/01/2016","% Complete":"100","Description":"Fold 1" } ]
Output
JSON object containing 'status', 'data', 'message'
Data will be same as input data with new folder id and parent folder id
Example:
Successful folder creation:
{
"data":
[
{
"Path":"/Service docs",
"Creation Date":"01/01/2016",
"Owner":"Company Administrator",
"Description":"Fold 1",
"% Complete":"100",
"Name":"REST Folder",
"node_id":"2003152"
}
],
"message":
[
{
"message":"OK"
}
],
"status":200
}
Failure Condition:
{
"data":
[
{
"Path":"/Service docs",
"Creation Date":"01/01/2016",
"Owner":"Company Administrator",
"Description":"Fold 1",
"% Complete":"100",
"Name":"REST Folder"
}
],
"message":
[
{
"message":"Folder with given name already exists"
}
],
"status":1043
}