Manage Content Workspaces in Marketing Cloud Next
Use content workspaces to organize and store your marketing content, such as emails and email templates. Use the CMS Spaces endpoints in Connect API to create and manage workspaces.
To create a workspace, issue a POST request to the /services/data/{apiVersion}/connect/cms/spaces endpoint.
| Property | Data Type | Description |
|---|---|---|
name | string | Required. The workspace name. |
description | string | A description of the workspace. |
defaultLanguage | string | The default language locale for the workspace, such ja_JP. |
spaceType | string | The type of workspace to create. Possible values are Marketing or Content. |
apiName | string | An API name for the workspace. |
This sample request shows how to create a marketing workspace.
If the request is successful, the response includes metadata about the workspace.
Copy the value of the id property. You use this ID to create content in the workspace.
To retrieve details about a specific workspace, issue a GET request to the /services/data/{apiVersion}/connect/cms/spaces/{contentSpaceOrFolderId} endpoint.
If the request is successful, the response includes workspace details.
To retrieve a list of all workspaces, issue a GET request to the /services/data/{apiVersion}/connect/cms/spaces endpoint. This table lists the query parameters that you can include in the request.
| Query Parameter | Data Type | Description |
|---|---|---|
nameFragment | string | A string of text to filter results by. The API returns only the workspaces with names that contain this value. |
page | int | The page number of results to return. The first page of results is page 0. |
pageSize | int | The number of results to return per page. The maximum value is 250. The default value is 25. |
This code example shows how to retrieve a list of all workspaces.
If the request is successful, the response includes a list of workspaces.
Use the id value from a workspace to create content in that workspace.
To update a workspace name or description, issue a PATCH request to the /services/data/{apiVersion}/connect/cms/spaces/{contentSpaceOrFolderId} endpoint. In the body of the request, include only the fields that you want to update.
You can’t change the ID of the workspace in a PATCH request.
This sample request shows how to change the name and description of a workspace.