Create new or rename directory

Create (operation=mkdir) or rename (operation=rename) a directory. p is the full path of the directory to create/rename and must not be /.

  • Create: requires the create right on the parent folder (since SecureCloud 13.0 also granted by custom permissions with create right). If the name already exists, the new directory is renamed automatically (e.g. folder (1)). With create_parents=true all missing parent folders are created (create right on the library root required). Returns 201 with header Location; with query reloaddir=true the listing of the parent directory is returned instead.
  • Rename: requires edit permission on the folder. If newname equals the old name, nothing is done and success is returned. If newname already exists, the folder is renamed automatically.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$

The unique identifier of a library

Query Params
string
required

Path to the dir, should not be /

string
enum

Only for mkdir: true returns the item list of the parent directory instead of success.

Allowed:
Body Params
string
enum
Allowed:
string
Defaults to false

whether to create multi-level directory, default false.

Responses

Language
Credentials
Bearer
Account-Token
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json