Create folder

Overview

This API creates a new folder under the given parent folder. If the parent folder ID is not given, a new folder is created under the shared folder.

Permissions

  • 'Create Folder' permission on each folder is required.
SecurityoAuthUser
Request
header Parameters
Accept-Language
required
string
Default: en-US

Language locale accepted by client (used for locale specific fields in resource representation and in error responses).

Enum: "en-US" "es-ES" "fr-FR" "it-IT" "de-DE" "nl-NL" "pt-BR" "pt-PT" "da-DK" "ru-RU" "fr-CA" "zh-CN" "ja-JP" "ko-KR" "sv-SE"
Request Body schema: application/json
Array of objects (link) >= 0 items
name
required
string (name) [ 1 .. 250 ] characters
description
string (description) [ 1 .. 250 ] characters
object (Folder)
required
object (Department)
access
string (access)
object (User)
translate
integer (translate)
object (ACL)
object (Permissions)
cascade
boolean (cascade)
required
object (language)

Language passed in the request must be assigned to user.

path
string (path)
isSystemCreated
boolean (isSystemCreated)
folderType
integer (folderType)
Responses
201

Created

400

Bad Request

401

Unauthorized

403

Forbidden

406

Not acceptable

412

Preconditions failed

500

Internal server error

post/folders
Request samples
application/json
{
  • "name": "Authoring Folder",
  • "parent": {
    },
  • "language": {
    }
}
Response samples
application/json

Required query parameter is missing

{
  • "code": "400-112",
  • "developerMessage": "Required query parameter(s) is missing. The following parameters are required: <param name>"
}