--- schema_version: "1" id: e9425c39cf515a3250ce8d0baf6773326d99002d77ad6fb9f1a211eff0f62ff5 title: Content - Workspaces (Connect API) collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/mc-core/references/generated-api-specs/mc-next-workspaces.md canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud-growth/references/mc-next-workspaces source_site: developer.salesforce.com content_type: documentation content_hash: f2df2489143d39943b28fb3c3a43f37ded2e186eb647093a4371f91fda657669 products: - Marketing Cloud Next - Marketing Cloud --- Content - Workspaces (Connect API) # Content - Workspaces (Connect API) Manage content management system (CMS) workspaces in Marketing Cloud Next by using the Connect API. Content workspaces organize and store your marketing content, such as emails and email templates. This table lists the use cases that REST API supports for CMS workspaces. | Supported Use Case | HTTP Verb | URI | | --- | --- | --- | | Create a workspace | [POST](/docs/marketing/marketing-cloud-growth/references/mc-next-workspaces?meta=createSpace) | /services/data/{apiVersion}/connect/cms/spaces | | List all workspaces | [GET](/docs/marketing/marketing-cloud-growth/references/mc-next-workspaces?meta=listSpaces) | /services/data/{apiVersion}/connect/cms/spaces | | Get a workspace by ID | [GET](/docs/marketing/marketing-cloud-growth/references/mc-next-workspaces?meta=getSpace) | /services/data/{apiVersion}/connect/cms/spaces/{contentSpaceOrFolderId} | | Update a workspace | [PATCH](/docs/marketing/marketing-cloud-growth/references/mc-next-workspaces?meta=updateSpace) | /services/data/{apiVersion}/connect/cms/spaces/{contentSpaceOrFolderId} | **Version:** v68.0 ## Servers * `https://{subdomain}.my.salesforce.com` * `subdomain (default (no default)) The unique API subdomain for your Salesforce org.` ## Operations ### GET listSpaces `GET /services/data/{apiVersion}/connect/cms/spaces` Operation ID: `listSpaces`. Tags: CMS Spaces. Retrieve a list of all content management system (CMS) workspaces in your organization. #### Parameters * `apiVersion` (path, string, required) The API version number. For example, `v68.0`. Default: `v68.0`. * `nameFragment` (query, string) A string of text to filter results by. Returns only workspaces with names that contain this value. Partial name matching is supported. * `page` (query, integer) The page number of results to return. The first page of results is page 0. Default: `0`. * `pageSize` (query, integer) The number of results to return per page. The maximum value is 250. The default value is 25. Default: `25`. Minimum: 1. Maximum: 250. #### Responses * **200** List of content workspaces. Media type: `application/json`. Schema: `SpacesResponse`. _Example_ ``` { "currentPageUrl": "/services/data/v68.0/connect/cms/spaces?page=0&pageSize=25", "nextPageUrl": null, "previousPageUrl": null, "spaces": [ { "apiName": "MCN_Workspace", "id": "0ZuQZ0000004YSv0AM", "name": "MCN Workspace", "spaceType": { "apiName": "marketing" } } ], "total": 1 } ``` * **401** The request requires authentication. Verify that your authorization token is valid and has not expired. Media type: `application/json`. Schema: `ErrorResponse`. _Example_ ``` [ { "errorCode": "UNAUTHORIZED", "message": "Session expired or invalid. Please login again." } ] ``` ### POST createSpace `POST /services/data/{apiVersion}/connect/cms/spaces` Operation ID: `createSpace`. Tags: CMS Spaces. Create a content management system (CMS) workspace to organize and store your marketing content. #### Parameters * `apiVersion` (path, string, required) The API version number. For example, `v68.0`. Default: `v68.0`. #### Request body (required) Media type: `application/json`. Schema: `CreateSpaceRequest`. _Example_ ``` { "name": "MCN Workspace", "description": "Content for MCN Workspace", "defaultLanguage": "en_US", "spaceType": "Marketing", "apiName": "MCN_Workspace" } ``` #### Responses * **201** Workspace created successfully. Media type: `application/json`. Schema: `SpaceResponse`. _Example_ ``` { "apiName": "MCN_Workspace", "createdBy": "005QZ000004x1CHYAY", "createdDate": "2026-03-23T18:01:08.000Z", "defaultLanguage": "en_US", "description": "Content for MCN Workspace", "fullyQualifiedName": "MCN_Workspace--marketing", "id": "0ZuQZ0000004YSv0AM", "isEnhancedSpace": true, "isFlowOrchestrationEnabled": true, "lastModifiedBy": "005QZ000004x1CHYAY", "lastModifiedDate": "2026-03-23T23:47:36.000Z", "name": "MCN Workspace", "rootFolderId": "9PuQZ0000004bLx0AI", "spaceType": { "apiName": "marketing" } } ``` * **400** The request couldn't be understood, typically due to a malformed request syntax. Media type: `application/json`. Schema: `ErrorResponse`. _Example_ ``` [ { "errorCode": "INVALID_INPUT", "message": "The request body is missing required fields or contains invalid values." } ] ``` * **401** The request requires authentication. Verify that your authorization token is valid and has not expired. Media type: `application/json`. Schema: `ErrorResponse`. _Example_ ``` [ { "errorCode": "UNAUTHORIZED", "message": "Session expired or invalid. Please login again." } ] ``` ### GET getSpace `GET /services/data/{apiVersion}/connect/cms/spaces/{contentSpaceOrFolderId}` Operation ID: `getSpace`. Tags: CMS Spaces. Retrieve details about a specific content management system (CMS) workspace by its ID. #### Parameters * `apiVersion` (path, string, required) The API version number. For example, `v68.0`. Default: `v68.0`. * `contentSpaceOrFolderId` (path, string, required) The ID of the content management system (CMS) workspace or folder. #### Responses * **200** Workspace details. Media type: `application/json`. Schema: `SpaceResponse`. _Example_ ``` { "apiName": "MCN_Workspace", "createdBy": "005QZ000004x1CHYAY", "createdDate": "2026-03-23T18:01:08.000Z", "defaultLanguage": "en_US", "description": "Content for MCN Workspace", "id": "0ZuQZ0000004YSv0AM", "name": "MCN Workspace", "rootFolderId": "9PuQZ0000004bLx0AI", "spaceType": { "apiName": "marketing" } } ``` * **401** The request requires authentication. Verify that your authorization token is valid and has not expired. Media type: `application/json`. Schema: `ErrorResponse`. _Example_ ``` [ { "errorCode": "UNAUTHORIZED", "message": "Session expired or invalid. Please login again." } ] ``` * **404** The requested resource couldn't be found. Verify that the workspace ID in your request is correct. Media type: `application/json`. Schema: `ErrorResponse`. _Example_ ``` [ { "errorCode": "NOT_FOUND", "message": "The requested workspace does not exist or is not accessible." } ] ``` ### PATCH updateSpace `PATCH /services/data/{apiVersion}/connect/cms/spaces/{contentSpaceOrFolderId}` Operation ID: `updateSpace`. Tags: CMS Spaces. Update an existing workspace's name or description. #### Parameters * `apiVersion` (path, string, required) The API version number. For example, `v68.0`. Default: `v68.0`. * `contentSpaceOrFolderId` (path, string, required) The ID of the content management system (CMS) workspace or folder. #### Request body (required) Media type: `application/json`. Schema: `UpdateSpaceRequest`. _Example_ ``` { "name": "Updated Workspace Name", "description": "Updated description for the workspace" } ``` #### Responses * **200** Workspace updated successfully. Media type: `application/json`. Schema: `SpaceResponse`. * **400** The request couldn't be understood, typically due to a malformed request syntax. Media type: `application/json`. Schema: `ErrorResponse`. _Example_ ``` [ { "errorCode": "INVALID_INPUT", "message": "The request body is missing required fields or contains invalid values." } ] ``` * **401** The request requires authentication. Verify that your authorization token is valid and has not expired. Media type: `application/json`. Schema: `ErrorResponse`. _Example_ ``` [ { "errorCode": "UNAUTHORIZED", "message": "Session expired or invalid. Please login again." } ] ``` * **404** The requested resource couldn't be found. Verify that the workspace ID in your request is correct. Media type: `application/json`. Schema: `ErrorResponse`. _Example_ ``` [ { "errorCode": "NOT_FOUND", "message": "The requested workspace does not exist or is not accessible." } ] ``` ## Schemas ### SpacesResponse * `currentPageUrl` (_string_) The URI for the current page of results. * `nextPageUrl` (_string_, nullable) The URI for the next page of results, if available. * `previousPageUrl` (_string_, nullable) The URI for the previous page of results, if available. * `spaces` (_array of object_) An array of workspace objects. * `apiName` (_string_) The API name of the workspace. * `id` (_string_) The ID of the workspace. * `name` (_string_) The workspace name. * `spaceType` (_object_) * `apiName` (_string_) The API name of the workspace type. * `total` (_integer_) The total number of workspaces. ### ErrorResponse Array of `object`. * `errorCode` (_string_) The error code. * `message` (_string_) A detailed error message. ### CreateSpaceRequest * `name` (_string_, required) Required. The workspace name. * `description` (_string_) A description of the workspace. * `defaultLanguage` (_string_) The default language locale for the workspace, such as `en_US` or `ja_JP`. * `spaceType` (_string_) The type of workspace to create. Allowed values: `Marketing`, `Content`. * `apiName` (_string_) An API name for the workspace. ### SpaceResponse * `apiName` (_string_) The API name of the workspace. * `createdBy` (_string_) The ID of the user who created the workspace. * `createdDate` (_string (date-time)_) The date and time when the workspace was created. * `defaultLanguage` (_string_) The default language locale for the workspace. * `description` (_string_) A description of the workspace. * `fullyQualifiedName` (_string_) The fully qualified name of the workspace. * `id` (_string_) The ID of the workspace. * `isEnhancedSpace` (_boolean_) Indicates whether the workspace is an enhanced space. * `isFlowOrchestrationEnabled` (_boolean_) Indicates whether flow orchestration is enabled for the workspace. * `lastModifiedBy` (_string_) The ID of the user who last modified the workspace. * `lastModifiedDate` (_string (date-time)_) The date and time when the workspace was last modified. * `name` (_string_) The workspace name. * `rootFolderId` (_string_) The ID of the root folder in the workspace. * `spaceType` (_object_) * `apiName` (_string_) The API name of the workspace type (for example, `marketing`, `content`). ### UpdateSpaceRequest * `name` (_string_) The workspace name. * `description` (_string_) A description of the workspace.