Manage Content Folders in Marketing Cloud Next

To organize content in a Marketing Cloud Next content workspace, use the folders endpoints in Connect API. Create folders under a parent folder, retrieve folder details, rename standard folders, and delete empty folders.

To create a folder, issue a POST request to the /services/data/{apiVersion}/connect/cms/folders endpoint.

Property	Data Type	Description
`name`	string	Required. The folder name. Names must start with a letter. They can’t contain leading or trailing white space, and can’t contain `--`, `__`, `.`, `\`, `/`, or `:`. The maximum length is 255 characters.
`parentFolderId`	string	Required. The ID of the parent folder where you create the folder.

This sample request creates a folder under an existing parent folder.

For a successful request, the response includes the new folder, its parent hierarchy, and other metadata.

To retrieve a folder, issue a GET request to the /services/data/{apiVersion}/connect/cms/folders/{folderId} endpoint. Replace {folderId} with the 18-character ID of the folder.

The response includes the folder details and the chain of folders from the root folder to the requested folder.

To rename a standard folder, issue a PATCH request to the /services/data/{apiVersion}/connect/cms/folders/{folderId} endpoint. Include only the name property in the request body.

Update only a folder’s name. You can’t move a folder to a different parent folder or rename a root folder.

To delete a folder, issue a DELETE request to the /services/data/{apiVersion}/connect/cms/folders/{folderId} endpoint.

A successful request returns 204 No Content and no response body.

You can delete only empty, non-root folders. If you try to delete a root folder or a folder that isn’t empty, the API returns an HTTP 400 response.