CMS Content Taxonomy Terms

Content admins use this resource to work with taxonomy term associations with CMS managed content. Content taxonomists use Content Taxonomy Term Resources to create, get, update, delete, and search content taxonomy terms.

Resource

1/connect/cms/contents/contentKeyOrId/taxonomy-terms

Available version

63.0

HTTP methods

GET, PATCH

Request body for PATCH

Root XML tag

<taxonomyTermsUpdates>

JSON example

1{
2"termsToAdd" : [
3   "15dxx000001X8UzBBJ",
4   "15dxx000001X8UzBBJ",
5   "15dxx000001X8UzDBK"
6   ],
7"termsToRemove" : [
8   "15dxx000001X8UzBCI"
9   ]
10}

Properties

Name	Type	Description	Required or Optional	Available Version
termsToAdd	String[]	List of IDs of the taxonomy terms to associate with managed content.	Required if termsToRemove isn't specified	63.0
termsToRemove	String[]	List of IDs of the taxonomy terms to remove their association with managed content.	Required if termsToAdd isn't specified	63.0

Request parameters for PATCH

Parameter Name	Type	Description	Required or Optional	Available Version
publish	Boolean	Specifies whether to publish the taxonomy term associations (true) or not (false). If unspecified, defaults to false. If content is published and has no outstanding changes, setting true publishes the taxonomy term association changes. Setting false saves the taxonomy term association changes and those changes are published along with the next content publish.	Optional	63.0

Response body for GET and PATCH

Managed Content Taxonomy Term Collection