Create a folder
const url = 'https://example.com/api/content/management/folders/example';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"name":"My New Folder","defaultType":"Article","description":"A folder for organizing articles","slug":"my-new-folder","parent":"FLD_PARENT123","readPerm":["editors","viewers"],"writePerm":["editors"],"deletePerm":["admin"]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/api/content/management/folders/example \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "My New Folder", "defaultType": "Article", "description": "A folder for organizing articles", "slug": "my-new-folder", "parent": "FLD_PARENT123", "readPerm": [ "editors", "viewers" ], "writePerm": [ "editors" ], "deletePerm": [ "admin" ] }'Creates a new folder for organizing content
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Repository configuration ID
Request Body
Section titled “Request Body”object
Folder name
Example
My New FolderDefault content type for items created in this folder
Example
ArticleFolder description
Example
A folder for organizing articlesCustom URL slug (auto-generated if not provided)
Example
my-new-folderParent folder ID for nested folders
Example
FLD_PARENT123Roles with read permission
Example
[ "editors", "viewers"]Roles with write permission
Example
[ "editors"]Roles with delete permission
Example
[ "admin"]Responses
Section titled “Responses”Folder created successfully
object
Folder ID
Folder name
Item type (always ‘Folder’)
Default content type for items in this folder
Folder description
URL-friendly slug
Normalized slug for searching
Creation timestamp (epoch ms)
Last update timestamp (epoch ms)
Whether folder is archived
Current version number
Latest version number
Whether this is the latest version
object
User’s username/login
User’s display name
User’s email address
object
User’s username/login
User’s display name
User’s email address
Parent folder ID
Roles with read permission
Roles with write permission
Roles with delete permission
Example
{ "id": "FLD_ABC123", "name": "My Folder", "type": "Folder", "defaultType": "Article", "slug": "my-folder", "createdDate": 1704067200000, "updatedDate": 1704153600000, "isArchived": false, "currentVersion": "0.1", "latestVersion": "0.1", "isLatestVersion": true, "createdByUser": { "userName": "user@example.com", "displayName": "John Doe", "email": "user@example.com" }, "updatedByUser": { "userName": "user@example.com", "displayName": "John Doe", "email": "user@example.com" }, "parent": "FLD_PARENT123", "readPerm": [ "admin", "editors" ], "writePerm": [ "admin", "editors" ], "deletePerm": [ "admin" ]}Invalid request