Create Folders by Parent Folder ID

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 250 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

}

Related Topics