Create Folder (POST)

Description

Creates a new folder in the specified location.

URL

All responses are in JSON format by default, to specify an XML response add ".xml" to the end of the method name (in this case "create_folder")

https://<yoursubdomain>.filetransfers.net/api/create_folder

Restrictions

The calling user must have:

Access to the specified location.
Create folders permissions in the specified location.

Parameters

Bold indicates required

Parameter	Description
folder_name	The name of the folder to be created.
folder_path	The location where the folder will be created. Paths can be retrieved from file_list.
api_key	Your API Key.
timestamp	The current time in Unix timestamp format.
signature	Please see "User Authentication" for more information.

Sample Response

Successful response In JSON:

{"createFolder":{
  "folder_id":1071266,
  "folder_name":"for_review",
  "folder_path":"\/Designers_workspace\/",
  "workspace_id":"4754"
   }
}

Successful response in XML:

<createFolder>
  <folder_id>1071267</folder_id>
  <folder_name>for_review</folder_name>
  <folder_path>/Designers_workspace/</folder_path>
  <workspace_id>4754</workspace_id>
</fileInfo>

Error response In JSON:

{"error":{"title":"Cannot create folder","message":"Please try a different location
or speak to an administrator."}}

Error response In XML:

<error>
	<title>Cannot create folder</title>
 	<message>Please try a different location or speak to an administrator.</message>
</error>