author	swapnil1993
title	contentType: associateWithHubSites
description	Associate a content type with a list of hub sites.
ms.localizationpriority	medium
doc_type	apiPageType
ms.subservice	sharepoint
ms.date	04/04/2024

contentType: associateWithHubSites

Namespace: microsoft.graph

Associate a published content type present in a content type hub with a list of hub sites.

Note: This feature is limited to tenants that have a SharePoint Syntex license.

[!INCLUDE national-cloud-support]

Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

[!INCLUDE permissions-table]

HTTP request

POST /sites/{siteId}/contentTypes/{contentTypeId}/associateWithHubSites

Note: The siteId represents a content type hub site.

Request headers

Name	Description
Authorization	Bearer {token}. Required. Learn more about authentication and authorization.
Content-Type	application/json. Required.

Request body

In the request body, supply a JSON representation of the parameters.

The following table shows the parameters that can be used with this action.

Parameter	Type	Description
hubSiteUrls	String collection	List of canonical URLs to the hub sites where the content type needs to be enforced. Required.
propagateToExistingLists	Boolean	If `true`, content types are enforced on existing lists in the hub sites; otherwise, they're applied only to newly created lists.

Response

If successful, this action returns a 204 No Content response code.

Example

Request

HTTP

POST https://graph.microsoft.com/v1.0/sites/{site-id}/contentTypes/{contentTypeId}/associateWithHubSites
Content-Type: application/json

{
   "hubSiteUrls":[
      "https://graph.microsoft.com/v1.0/sites/{site-id}"
   ],
   "propagateToExistingLists":false
}