Skip to main content
English (US) Nederlands

Assets Server REST API - create folder

Updated

POST

http://yourserver.com/services/createFolder
    ?path=<folder path>

What does it do?

Create one or more folders.

Log in requirement

Before being able to request information from Assets Server by using a GET request or make changes to the system through a POST request, a log in to Assets Server is required. For information about the available APIs for logging in, see Assets Server REST API - introduction.

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 Assets 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 Assets Server 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 folderPaths 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.assets-server.com/services/createFolder
    ?path=/Demo Zone/My Folder

Create multiple folders

createFolder

http://demo.assets-server.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"
}

Related articles

Comments

2 comments

Date Votes
  • Andres Hirsbrunner

    There seems to be a typo “olderPaths” instead of “FolderPaths”

    0
  • Maarten van Kleinwee
    • Documentation team

    Hi Andres,

    Many thanks for highlighting this. It has been corrected now.

    Best regards,

    Maarten van Kleinwee
    Senior Technical Writer, WoodWing Software 

    0

Please sign in to leave a comment.