POST http://yourserver.com/services/createFolder ?path=<folder path> |
What does it do?
Create one or more folders.
POST requests only
This REST API only accepts POST requests, not GET requests. Also, the POST request needs to include a cross-site request forgery (csrf) token.
The csrf token is a unique code which, by including it in the request, also makes the POST request unique and therefore much more secure.
The csrf token is obtained by first logging in to Elvis Server through a POST request. The response that is received will include the csrf token which can then be used in subsequent POST requests as a http header:
"X-CSRF-TOKEN: <some_csrf_token>"
For more information including examples, see Elvis 6 REST API - Performing a POST request with a csrf token.
Parameters
path |
The full folderPath of the folder to be created. This same parameter name can be specified multiple times to create several folders with one call. Required |
Return value
A JSON object with the olderPaths of each folder as key with the corresponding result as value (always a string). The following results are possible:
- "created"
- "already exists"
- "access denied"
- an error message indicating why the folder could not be created
<normalized folder path> | created | already exists | access denied | <an error message> |
Examples
Create folder
createFolder http://demo.elvisdam.com/services/createFolder ?path=/Demo Zone/My Folder |
Create multiple folders
createFolder http://demo.elvisdam.com/services/createFolder ?path=/Demo Zone/Images &path=/DAMtube |
The JSON result returned by the service has the following format and information.
{
"/Demo Zone" : "access denied",
"/DAMtube" : "already exists"
}
Comment
Do you have corrections or additional information about this article? Leave a comment! Do you have a question about what is described in this article? Please contact Support.
0 comments
Please sign in to leave a comment.